О параметрах и свойствах установки клиента в Configuration Manager
Используйте команду CCMSetup.exe для установки клиента Configuration Manager. Если вы предоставляете параметры установки клиента в командной строке, они изменяют поведение установки. Если вы предоставляете свойства установки клиента в командной строке, они изменяют начальную конфигурацию установленного клиентского агента.
О CCMSetup.exe
Команда CCMSetup.exe загружает необходимые файлы для установки клиента из точки управления или источника. Эти файлы могут включать:
Пакет Windows установки client.msi, устанавливаемого клиентского программного обеспечения
Обновления и исправления для клиента Configuration Manager
Вы не можете непосредственно установить client.msi.
CCMSetup.exe параметров командной строки для настройки установки. Параметры префиксом с помощью косой черты ( / ) и, как правило, ниже. Вы указываете значение параметра при необходимости с помощью двоеточия ( : ) сразу после этого значения. Дополнительные сведения см. вCCMSetup.exe параметров командной строки.
Вы также можете предоставить свойства в командной CCMSetup.exe, чтобы изменить поведение client.msi. Свойства по соглашению являются верхним корпусом. Вы указываете значение для свойства с помощью равного знака ( = ) сразу после этого значения. Дополнительные сведения см. вClient.msi свойствах.
Укажите параметры CCMSetup, прежде чем указать свойства для client.msi.
CCMSetup.exe и вспомогательные файлы находятся на сервере сайта в папке Клиент в папке установки Configuration Manager. Диспетчер конфигурации делит эту папку с сетью в совместной веб-сайте. Например, \\SiteServer\SMS_ABC\Client .
В командной подсказке команда CCMSetup.exe использует следующий формат:
CCMSetup.exe [<Ccmsetup parameters>] [<client.msi setup properties>]
CCMSetup.exe /mp:SMSMP01 /logon SMSSITECODE=S01 FSP=SMSFSP01
В этом примере делается следующее:
Указывает точку управления с именем SMSMP01 для запроса списка точек рассылки для скачивания файлов установки клиента.
Указывает, что установка должна прекратиться, если версия клиента уже существует на компьютере.
Предписывает client.msi назначить клиента коду сайта S01.
Предписывает client.msi использовать точку состояния отката с именем SMSFP01.
Если значение параметра имеет пробелы, окружай его кавычками.
Если расширить схему Active Directory для Configuration Manager, сайт публикует множество свойств установки клиента в службах домена Active Directory. Клиент Configuration Manager автоматически читает эти свойства. Дополнительные сведения см. в публикации О свойствах установки клиента, опубликованных в службе домена Active Directory.
CCMSetup.exe командной строки
Показывает доступные параметры командной строки для ccmsetup.exe.
/AllowMeteredС помощью этого параметра можно управлять поведением клиента в сети со счетчиками. Этот параметр не принимает значения. Когда вы разрешаете клиентскую связь в сети для ccmsetup, она загружает контент, регистрируется на сайте и скачивает начальную политику. Любое дальнейшее сообщение клиента следует конфигурации параметра клиента из этой политики. Дополнительные сведения см. в дополнительных сведениях о параметрах клиента.
Если переустановить клиента на существующем устройстве, он использует следующий приоритет для определения его конфигурации:
- Существующая локализованная клиентская политика
- Последняя строка команд, хранимая в Windows реестре
- Параметры командной строки ccmsetup
Этот параметр указывает, будет ли клиент автоматически обновляться при включаемом автоматическом обновлении клиента.
- TRUE : Клиент не будет автоматически обновляться
- FALSE : Клиент автоматически обновляется (по умолчанию)
Дополнительные сведения см. в дополнительных сведениях, которые см. в расширенном клиенте для работы с клиентами.
При использовании параметра /AlwaysExcludeUpgrade по-прежнему выполняется автоматическое обновление. Однако, когда CCMSetup запускается для выполнения обновления, он заметит, /AlwaysExcludeUpgrade что параметр был задан и будет входить в следующую строку в ccmsetup.log:
Client is stamped with /alwaysexcludeupgrade. Stop proceeding.
После этого CCMSetup немедленно выйдет и не выполнит обновление.
/BITSPriorityКогда устройство скачивает файлы установки клиента через подключение HTTP, используйте этот параметр, чтобы указать приоритет загрузки. Укажите одно из следующих возможных значений:
NORMAL (по умолчанию)
Пример: ccmsetup.exe /BITSPriority:HIGH
/configЭтот параметр указывает текстовый файл, в который перечислены свойства установки клиента.
Если CCMSetup выполняется как служба, поместите этот файл в папку системы CCMSetup: %Windir%\Ccmsetup .
При указании параметра /noservice поместите этот файл в ту же папку, что и CCMSetup.exe.
Пример: CCMSetup.exe /config:"configuration file name.txt"
Чтобы обеспечить правильный формат файла, используйте файл mobileclienttemplate.tcf \bin\<platform> в папке в каталоге установки Configuration Manager на сервере сайта. В этом файле есть комментарии по разделам и их использованию. Укажите свойства установки клиента в разделе [Client Install] после следующего текста: Install=INSTALL=ALL .
Пример [Client Install] записи раздела: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100
/downloadtimeoutЕсли CCMSetup не удается скачать файлы установки клиента, этот параметр указывает максимальное время в минутах. После этого времени работы CCMSetup перестает загружать файлы установки. Значение по умолчанию — 1440 минут (один день).
Используйте параметр /retry , чтобы указать интервал между попытками повторной попытки.
Пример: ccmsetup.exe /downloadtimeout:100
/ExcludeFeaturesЭтот параметр указывает, CCMSetup.exe не устанавливает указанную функцию.
Пример: CCMSetup.exe /ExcludeFeatures:ClientUI не устанавливает центр программного обеспечения на клиента.
ClientUI это единственное значение, которое поддерживает /ExcludeFeatures параметр.
/forceinstallУкажите, CCMSetup.exe анинсталирует любой существующий клиент и установит нового клиента.
/forcerebootИспользуйте этот параметр, чтобы заставить компьютер перезапустить при необходимости для завершения установки. Если этот параметр не указан, CCMSetup выходит из него при необходимости перезапуска. Затем он продолжается после следующей ручной перезагрузки.
Пример: CCMSetup.exe /forcereboot
/logonЕсли уже установлена любая версия клиента, этот параметр указывает, что установка клиента должна прекратиться.
Пример: ccmsetup.exe /logon
Указывает точку управления исходным кодом для подключений компьютеров. Компьютеры используют эту точку управления, чтобы найти ближайшую точку распространения файлов установки. Если нет точек распространения или компьютеры не могут скачать файлы из точек рассылки через четыре часа, они загружают файлы из указанной точки управления.
Дополнительные сведения о том, как ccmsetup загружает контент, см. в материалах Boundary groups - client installation. В этой статье также содержатся сведения о поведении ccmsetup при использовании и /mp /source параметров.
Этот параметр указывает начальную точку управления для компьютеров для поиска источника загрузки и может быть любой точкой управления на любом сайте. Он не назначает клиента указанной точке управления.
Компьютеры загружают файлы через подключение HTTP или HTTPS в зависимости от конфигурации роли системы сайта для клиентских подключений. При настройке загрузки можно также использовать регулирование BITS. Если настроены все точки распространения и точки управления только для подключений клиентов HTTPS, убедитесь, что клиентский компьютер имеет действительный клиентский сертификат.
Параметр командной /mp строки можно указать несколько точки управления. Если компьютер не подключается к первому, он пробует следующий в указанном списке. При указании нескольких точек управления разделять значения по полуколонам.
Если клиент подключается к точке управления с помощью HTTPS, укажите имя FQDN, а не имя компьютера. Значение должно соответствовать объекту управления сертификатом PKI Subject или Subject Alternative Name. Хотя диспетчер конфигурации поддерживает использование имени компьютера в сертификате для подключений в интрасети, рекомендуется использовать FQDN.
Пример с именем компьютера: ccmsetup.exe /mp:SMSMP01
Пример с FQDN: ccmsetup.exe /mp:smsmp01.contoso.com
Этот параметр также может указывать URL-адрес шлюза облачного управления (CMG). Используйте этот URL-адрес для установки клиента на устройстве, основанном на Интернете. Чтобы получить значение для этого параметра, используйте следующие действия:
Создание CMG. Дополнительные сведения см. в перенастройку CMG.
В активном клиенте откройте команду Windows PowerShell в качестве администратора.
Выполните следующую команду:
Приложение префикса https:// для использования с параметром /mp .
Пример использования URL-адреса шлюза облачного управления: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100
При указании URL-адреса шлюза /mp управления облаком для параметра необходимо начать с https:// .
/NoCRLCheckУказывает, что клиент не должен проверять список отзыва сертификата (CRL) при общении по HTTPS с сертификатом PKI. Если этот параметр не указан, клиент проверяет CRL, прежде чем установить подключение HTTPS. Дополнительные сведения о клиентской проверке CRL см. в справке Planning for PKI certificate revocation.
Пример: CCMSetup.exe /UsePKICert /NoCRLCheck
/noserviceЭтот параметр предотвращает запуск CCMSetup в качестве службы, которую он делает по умолчанию. Когда CCMSetup выполняется как служба, она выполняется в контексте учетной записи локальной системы компьютера. Эта учетная запись может не иметь достаточных прав для доступа к требуемой сетевой ресурс для установки. С /noservice CCMSetup.exe выполняется в контексте учетной записи пользователя, используемой для запуска установки.
Пример: ccmsetup.exe /noservice
/regtokenЭтот параметр используется для предоставления маркера массовой регистрации. Устройство, основанное на Интернете, использует этот маркер в процессе регистрации через шлюз облачного управления (CMG). Дополнительные сведения см. в деле проверки подлинности на основе маркеров для CMG.
При использовании этого параметра также включаем следующие параметры и свойства:
В следующем примере командная строка содержит другие необходимые параметры установки и свойства:
ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 SMSSITECODE=ABC SMSMP=https://mp1.contoso.com /regtoken:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik9Tbzh2Tmd5VldRUjlDYVh5T2lacHFlMDlXNCJ9.eyJTQ0NNVG9rZW5DYXRlZ29yeSI6IlN7Q01QcmVBdXRoVG9rZW4iLCJBdXRob3JpdHkiOiJTQ0NNIiwiTGljZW5zZSI6IlNDQ00iLCJUeXBlIjoiQnVsa1JlZ2lzdHJhdGlvbiIsIlRlbmFudElkIjoiQ0RDQzVFOTEtMEFERi00QTI0LTgyRDAtMTk2NjY3RjFDMDgxIiwiVW5pcXVlSWQiOiJkYjU5MWUzMy1wNmZkLTRjNWItODJmMy1iZjY3M2U1YmQwYTIiLCJpc3MiOiJ1cm46c2NjbTpvYXV0aDI6Y2RjYzVlOTEtMGFkZi00YTI0LTgyZDAtMTk2NjY3ZjFjMDgxIiwiYXVkIjoidXJuOnNjY206c2VydmljZSIsImV4cCI6MTU4MDQxNbUwNSwibmJmIjoxNTgwMTU2MzA1fQ.ZUJkxCX6lxHUZhMH_WhYXFm_tbXenEdpgnbIqI1h8hYIJw7xDk3wv625SCfNfsqxhAwRwJByfkXdVGgIpAcFshzArXUVPPvmiUGaxlbB83etUTQjrLIk-gvQQZiE5NSgJ63LCp5KtqFCZe8vlZxnOloErFIrebjFikxqAgwOO4i5ukJdl3KQ07YPRhwpuXmwxRf1vsiawXBvTMhy40SOeZ3mAyCRypQpQNa7NM3adCBwUtYKwHqiX3r1jQU0y57LvU_brBfLUL6JUpk3ri-LSpwPFarRXzZPJUu4-mQFIgrMmKCYbFk3AaEvvrJienfWSvFYLpIYA7lg-6EVYRcCAA
Если CCMSetup возвращает ошибку 0x87d0027e, /mp попробуйте удалить параметр из командной строки.
/retryЕсли CCMSetup.exe не удается скачать файлы установки, используйте этот параметр, чтобы указать интервал повторной работы в минутах. CCMSetup продолжает повторить, пока не достигнет предела, указанного в параметре /downloadtimeout .
Пример: ccmsetup.exe /retry:20
/serviceУказывает, что CCMSetup должен работать как служба, использующая учетную запись локальной системы.
Если вы используете сценарий для запуска CCMSetup.exe параметра /service , CCMSetup.exe после запуска службы. Он может неправильно сообщать в сценарий сведения об установке.
Пример: ccmsetup.exe /service
/skipprereqЭтот параметр указывает, CCMSetup.exe не устанавливает указанное условие. Вы можете ввести несколько значений. Используйте символ semicolon ( ; ) для отделить каждое значение.
Дополнительные сведения о клиентских предпосылках см. в Windows клиентских предпосылок.
/sourceУказывает расположение загрузки файла. Используйте локальный или unC-путь. Устройство загружает файлы с помощью протокола блока сообщений сервера (SMB). Для использования /source учетная запись Windows для установки клиента нуждается в разрешениях на чтение в расположении.
Дополнительные сведения о том, как ccmsetup загружает контент, см. в материалах Boundary groups - client installation. В этой статье также содержатся сведения о поведении ccmsetup при использовании и /mp /source параметров.
Параметр можно использовать несколько /source раз в командной строке для указания альтернативных местоположений загрузки.
Пример: ccmsetup.exe /source:"\\server\share"
/uninstallС помощью этого параметра можно удалить клиента Configuration Manager. Дополнительные сведения см. в перенастройке "Удалить клиента".
Пример: ccmsetup.exe /uninstall
Начиная с версии 2111, когда клиент удаляется, он также удаляет загрузчик клиента, ccmsetup.msi, если он существует.
/UsePKICertУкажите этот параметр для клиента, чтобы использовать сертификат проверки подлинности клиента PKI. Если этот параметр не включен или клиент не может найти допустимый сертификат, он отфильтрует все точки управления HTTPS, включая шлюзы управления облаками (CMG). Клиент использует подключение HTTP с самозаверяемым сертификатом.
Пример: CCMSetup.exe /UsePKICert
Если устройство использует Azure Active Directory (Azure AD) для проверки подлинности клиента, а также имеет сертификат проверки подлинности клиента на основе PKI, если вы используете этот параметр, клиент не сможет получать сведения о onboarding Azure AD из шлюза управления облаком (CMG). Для клиента, который использует проверку подлинности Azure AD, не укажите этот параметр, но включайте свойства AADRESOURCEURI и AADCLIENTAPPID .
В некоторых сценариях не нужно указывать этот параметр, но при этом используйте клиентский сертификат. Например, клиентская установка клиентского push и обновления программного обеспечения. Используйте этот параметр при установке клиента вручную и используйте /mp его с помощью точки управления с поддержкой HTTPS.
Кроме того, укажите этот параметр при установке клиента для связи только для Интернета. Используйте CCMALWAYSINF=1 вместе со свойствами для точки управления на основе Интернета ( CCMHOSTNAME ) и кода сайта ( SMSSITECODE ). Дополнительные сведения об управлении клиентом на основе Интернета см. в статью Considerations for client communications from the internet or an untrusted forest.
/IgnoreSkipUpgradeУкажите этот параметр, чтобы вручную обновить исключенного клиента. Дополнительные сведения см. в дополнительных сведениях о том, как исключить клиентов из обновления.
CCMSetup.exe коды возврата
Команда CCMSetup.exe содержит следующие коды возврата. Чтобы устранить неполадки, %WinDir%\ccmsetup\Logs\ccmsetup.log просмотрите на клиенте контекст и дополнительные подробности о кодах возврата.
Код возврата Смысл 0 Успешно 6 Ошибка 7 Требуется перезагрузка 8 Настройка уже запущена 9 Сбой предварительной оценки 10 Сбой проверки хаширования манифеста установки
Ccmsetup.msi свойства
Следующие свойства могут изменять поведение установки ccmsetup.msi.
CCMSETUPCMDИспользуйте этот ccmsetup. свойство msi , чтобы передать в ccmsetup дополнительные параметры и свойства командной строки. exe. Включить другие параметры и свойства внутри кавычка ( " ). Используйте это свойство при загрузке клиента Configuration Manager с помощью метода установки Intune MDM.
Пример: ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"
Microsoft Intune ограничивает командную строку 1024 символами.
Client.msi свойства
Следующие свойства могут изменять поведение установки client.msi, ccmsetup.exe устанавливается.
AADCLIENTAPPIDУказывает идентификатор клиентского приложения Azure Active Directory Azure AD. Вы создаете или импортируете клиентские приложения при настройке служб Azure для облачного управления. Администратор Azure может получить значение для этого свойства с портала Azure. Дополнительные сведения см. в приложении Get ID. Для свойства AADCLIENTAPPID этот ID приложения для типа приложения Native .
Пример: ccmsetup.exe AADCLIENTAPPID=aa28e7f1-b88a-43cd-a2e3-f88b257c863b
AADRESOURCEURIУказывает идентификатор приложения-сервера Azure AD. Вы создаете или импортируете серверное приложение при настройке служб Azure для облачного управления. При создании приложения-сервера в окне Create Server Application это свойство — URI app ID.
Администратор Azure может получить значение для этого свойства с портала Azure. В Azure Active Directory найти сервер приложение под регистрациями Приложения. Поиск веб-приложения типа приложения / API. Откройте приложение, выберите Параметры, а затем выберите Свойства. Используйте значение URI ID приложения для этого AADRESOURCEURI свойства установки клиента.
Пример: ccmsetup.exe AADRESOURCEURI=https://contososerver
AADTENANTIDУказывает идентификатор клиента Azure AD. Диспетчер конфигурации связывается с этим клиентом при настройке служб Azure для облачного управления. Чтобы получить значение для этого свойства, используйте следующие действия:
На устройстве, которое Windows 10 или позже и присоединяется к одному и том же клиенту Azure AD, откройте командную команду.
Выполните следующую команду: dsregcmd.exe /status
В разделе Состояние устройства найдите значение TenantId . Пример: TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a
Администратор Azure также может получить это значение на портале Azure. Дополнительные сведения см. в получить ID клиента.
Пример: ccmsetup.exe AADTENANTID=607b7853-6f6f-4d5d-b3d4-811c33fdd49a
CCMADMINSУказывает одну или несколько Windows учетных записей или групп пользователей, которые будут иметь доступ к настройкам и политикам клиента. Это свойство полезно, если на клиентом компьютере нет локальных административных учетных данных. Укажите список учетных записей, разделенных зайколонами ( ; ).
Пример: CCMSetup.exe CCMADMINS="domain\account1;domain\group1"
CCMALLOWSILENTREBOOTПри необходимости разрешить компьютеру бесшумную перезагрузку после установки клиента.
При использовании этого свойства компьютер перезапускается без предупреждения. Такое поведение происходит даже в том случае, если пользователь вошел в Windows.
Пример: CCMSetup.exe CCMALLOWSILENTREBOOT
CCMALWAYSINFЧтобы указать, что клиент всегда находится в Интернете и никогда не подключается к интрасети, 1 закажите значение свойства . Тип подключения клиента отображает Always Internet.
Используйте это свойство с помощью CCMHOSTNAME , чтобы указать FQDN точки управления на основе Интернета. Также используйте его с параметром CCMSetup UsePKICert и свойством SMSSITECODE .
Дополнительные сведения об управлении клиентом на основе Интернета см. в статью Considerations for client communications from the internet or an untrusted forest.
Пример: CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC
CCMCERTISSUERSИспользуйте это свойство, чтобы указать список эмитентов сертификатов. В этом списке содержатся сведения о сертификатах для доверенных корневых органов сертификации (CA), которые доверяет сайту Configuration Manager.
Это значение соответствует атрибутам субъекта, которые находятся в корневом сертификате ЦС. Разделять атрибуты запятой ( , ) или запятой ( ; ). Укажите несколько корневых сертификатов ЦС с помощью панели сепараторов ( | ).
Пример: CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."
Используйте значение атрибута CertificateIssuers в файле mobileclient.tcf для сайта. Этот файл находится в подмостке \bin\<platform> каталога установки Configuration Manager на сервере сайта.
Дополнительные сведения о списке эмитентов сертификатов и о том, как клиенты используют его во время процесса выбора сертификата, см. в справке Planning for PKI client certificate selection.
CCMCERTSELЕсли клиент имеет несколько сертификатов для связи HTTPS, в этом свойстве указаны критерии выбора действительного сертификата проверки подлинности клиента.
Используйте следующие ключевые слова для поиска имени субъекта сертификата или альтернативного имени субъекта:
- Subject : Поиск точного совпадения
- SubjectStr : Поиск частичного совпадения
CCMCERTSEL="Subject:computer1.contoso.com" : Поиск сертификата с точным совпадением computer1.contoso.com с именем компьютера в имени субъекта или альтернативного имени субъекта.
CCMCERTSEL="SubjectStr:contoso.com" : Поиск сертификата, содержащемся contoso.com в имени субъекта или альтернативном имени субъекта.
Используйте ключевое SubjectAttr слово для поиска идентификатора объекта (OID) или отличительных атрибутов имени в имени субъекта или альтернативного имени субъекта.
CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers" : Поиск атрибута организационного подразделения, выраженного в качестве идентификатора объекта и названного Computers .
CCMCERTSEL="SubjectAttr:OU = Computers" : Поиск атрибута организационного подразделения, выраженного как отличительное имя и именуемого Computers .
Если вы используете имя субъекта, ключевое Subject слово является чувствительным к делу, SubjectStr а ключевое слово — нечувствительным к делу.
Если вы используете альтернативное имя субъекта, как Subject SubjectStr ключевые слова, так и ключевые слова нечувствительны к делу.
Полный список атрибутов, которые можно использовать для выбора сертификата, см. в списке Поддерживаемые значения атрибутов для критериев выбора сертификата PKI.
Если несколько сертификатов совпадают с поиском, CCMFIRSTCERT 1 и вы заданы, то клиент-установщик выбирает сертификат с самым длительным сроком действия.
CCMCERTSTOREЕсли установщик клиента не может найти допустимый сертификат в хранилище персональных сертификатов по умолчанию для компьютера, используйте это свойство, чтобы указать альтернативное имя магазина сертификатов.
Пример: CCMSetup.exe /UsePKICert CCMCERTSTORE="ConfigMgr"
CCMDEBUGLOGGINGЭто свойство позволяет отламывка журналов при установке клиента. Это свойство заставляет клиента входить в журнал низкоуровневой информации для устранения неполадок. Избегайте использования этого свойства на производственных сайтах. Может возникать чрезмерная лесозаготовка, что может затруднить поиск соответствующих сведений в файлах журнала. Также включить CCMENABLELOGGING .
- 0 : Отключите ведение журнала отключения (по умолчанию)
- 1 : Включаем ведение журнала отключки
Пример: CCMSetup.exe CCMDEBUGLOGGING=1
CCMENABLELOGGINGДиспетчер конфигурации включает ведение журнала по умолчанию.
- TRUE : Включаем ведение журнала (по умолчанию)
- FALSE : Отключить ведение журнала
Пример: CCMSetup.exe CCMENABLELOGGING=TRUE
CCMEVALINTERVALЧастота в минутах, с которой выполняется средство оценки состояния здоровья клиента (ccmeval.exe). Укажите значение integer от 1 до 1440 . По умолчанию ccmeval выполняется один раз в день (1440 минут).
Пример: CCMSetup.exe CCMEVALINTERVAL=1440
Дополнительные сведения об оценке состояния здоровья клиентов см. в сайте Monitor clients.
CCMEVALHOURЧас в течение дня, когда выполняется средство оценки состояния здоровья клиента (ccmeval.exe). Укажите значение integer от 0 (полночь) до 23 (11:00 вечера). По умолчанию ccmeval выполняется в полночь.
Дополнительные сведения об оценке состояния здоровья клиентов см. в сайте Monitor clients.
CCMFIRSTCERTЕсли задано это свойство 1 , клиент выбирает сертификат PKI с самым длительным сроком действия.
Пример: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1
CCMHOSTNAMEЕсли клиент управляется через Интернет, это свойство указывает FQDN точки управления на основе Интернета.
Не укажите этот параметр с свойством установки SMSSITECODE=AUTO . Непосредственно назначать интернет-клиентов на сайт, основанный на Интернете.
Пример: CCMSetup.exe /UsePKICert CCMHOSTNAME="SMSMP01.corp.contoso.com"
Это свойство может указывать адрес шлюза облачного управления (CMG). Чтобы получить значение для этого свойства, используйте следующие действия:
Создание CMG. Дополнительные сведения см. в перенастройку CMG.
В активном клиенте откройте команду Windows PowerShell в качестве администратора.
Выполните следующую команду:
Используйте возвращенное значение как есть с свойством CCMHOSTNAME .
Пример: ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100
При указании адреса CMG CCMHOSTNAME для свойства не задайте префикс, например https:// . Используйте этот префикс только с URL-адресом /mp CMG.
CCMHTTPPORTУказывает порт, который клиент должен использовать, когда он передает через HTTP на системные серверы сайтов. По умолчанию это значение 80 .
Пример: CCMSetup.exe CCMHTTPPORT=80
CCMHTTPSPORTУказывает порт, который клиент должен использовать, когда он передает через HTTPS на системные серверы сайтов. По умолчанию это значение 443 .
Пример: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443
CCMINSTALLDIRИспользуйте это свойство, чтобы установить папку для установки клиентских файлов Configuration Manager. По умолчанию он использует %WinDir%\CCM .
Независимо от того, где вы устанавливаете клиентские файлы, он всегда ccmcore.dllфайл в папке %WinDir%\System32 . На 64-битной ОС он устанавливает копию ccmcore.dll в папку %WinDir%\SysWOW64 . Этот файл поддерживает 32-битные приложения, которые используют 32-битную версию API клиента из SDK Configuration Manager.
Пример: CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"
CCMLOGLEVELИспользуйте это свойство, чтобы указать уровень детализации для записи в файлы журнала Configuration Manager.
- 0 : Многословие
- 1 : По умолчанию
- 2 : Предупреждения и ошибки
- 3 : Только ошибки
Пример: CCMSetup.exe CCMLOGLEVEL=0
CCMLOGMAXHISTORYКогда файл журнала Configuration Manager достигает максимального размера, клиент переименовает его в резервный и создает новый файл журнала. Это свойство указывает, сколько предыдущих версий файла журнала необходимо сохранить. Значение по умолчанию — 1 . Если вы задасте значение 0 , клиент не будет хранить историю файлов журнала.
Пример: CCMSetup.exe CCMLOGMAXHISTORY=5
CCMLOGMAXSIZEЭто свойство указывает максимальный размер файла журнала в bytes. Когда журнал растет до указанного размера, клиент переименовывайте его в файл истории и создает новый. Размер по умолчанию — 250 000 bytes, а минимальный — 10 000.
Пример: CCMSetup.exe CCMLOGMAXSIZE=300000 (300 000 битов)
DISABLESITEOPTУстановите это свойство, TRUE чтобы заблокировать администраторам изменение назначенного сайта в панели управления Configuration Manager.
Пример: CCMSetup.exe DISABLESITEOPT=TRUE
DISABLECACHEOPTЕсли установлено true, это свойство отключает возможность административных пользователей изменять параметры папок кэша клиента в панели управления Configuration Manager .
Пример: CCMSetup.exe DISABLECACHEOPT=TRUE
DNSSUFFIXУкажите домен DNS для клиентов, чтобы найти точки управления, опубликованные в DNS. Когда клиент находит точку управления, он рассказывает клиенту о других точках управления в иерархии. Это поведение означает, что точка управления, которую клиент находит из DNS, может быть любой в иерархии.
Не нужно указывать это свойство, если клиент находится в том же домене, что и опубликованная точка управления. В этом случае домен клиента автоматически используется для поиска DNS для точек управления.
Дополнительные сведения о публикации DNS в качестве метода расположения служб для клиентов Configuration Manager см. в публикации Расположение службы и определение клиентами назначенной точки управления.
По умолчанию диспетчер конфигурации не включает публикацию DNS.
Пример: CCMSetup.exe SMSSITECODE=ABC DNSSUFFIX=contoso.com
Укажите точку состояния отката, которая получает и обрабатывает сообщения состояния, отправленные клиентами Configuration Manager.
Пример: CCMSetup.exe FSP=SMSFP01
IGNOREAPPVVERSIONCHECKЕсли задайте это TRUE свойство, клиент-установщик не проверяет минимальную требуемую версию виртуализации приложений Майкрософт (App-V).
Если установить клиент Configuration Manager без установки App-V, вы не сможете развернуть виртуальные приложения.
Пример: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE
MANAGEDINSTALLERЕсли вы установите это 1 свойство, ccmsetup.exe и client.msi заданной как управляемые установщики. Дополнительные сведения см. в приложении Automatically allow deployed by a managed installer with Защитник Windows Application Control.
Пример: CCMSetup.exe MANGEDINSTALLER=1
NOTIFYONLYКогда вы включаете это свойство, клиент сообщает состояние, но не устраняет проблемы, которые он находит.
Пример: CCMSetup.exe NOTIFYONLY=TRUE
PROVISIONTSИспользуйте это свойство, чтобы запустить последовательность задач для клиента после успешной регистрации на сайте.
Если в последовательности задач устанавливаются обновления программного обеспечения или приложения, клиентам требуется действительный сертификат проверки подлинности клиента. Проверка подлинности маркеров не работает. Дополнительные сведения см. в выпуске Заметки - развертывание ОС.
Например, вы Windows устройство с Windows автопилотом, автоматически зарегистрив его в Microsoft Intune, а затем установите клиент Configuration Manager для совместного управления. Если указать этот новый параметр, новый клиент, который был создан, запускает последовательность задач. Этот процесс предоставляет дополнительную гибкость для установки приложений и обновлений программного обеспечения или настройки параметров.
Используйте следующий процесс:
Создайте последовательность задач развертывания без ОС для установки приложений, установки обновлений программного обеспечения и настройки параметров.
Размести эту последовательность задач в новой встроенной коллекции All Provisioning Devices. Обратите внимание, например, на ID развертывания последовательности задач PRI20001 .
Цель развертывания может быть либо доступной, либо необходимой. Так как в качестве свойства указывается ИД развертывания, цель не имеет значения.
Установите клиент Configuration Manager на устройство с ccmsetup.msiи включив в него следующее свойство: PROVISIONTS=PRI20001 . Установите значение этого свойства в качестве ID развертывания последовательности задач.
Если вы устанавливаете клиента из Intune во время регистрации совместной системы управления, см. в интернете подготовку устройств к совместному управлению.
Этот метод может иметь дополнительные предпосылки. Например, регистрация сайта на Azure Active Directory или создание шлюза облачного управления с поддержкой контента.
Независимо от метода, используйте это свойство только с ccmsetup.msi.
После установки и правильной регистрации клиента на сайте начинается эталонная последовательность задач. Если регистрация клиента не состоится, последовательность задач не начнется.
Последовательность задач, запущенная с помощью PROVISIONTS клиентской Параметры. Эта последовательность задач начинается сразу после регистрации клиента, поэтому она не будет частью коллекции, в которую были развернуты настраиваемые параметры клиента. Клиент не обрабатывает и не применяет настраиваемые параметры клиента до запуска этой последовательности задач.
Для правильной работы последовательности задач может потребоваться изменить определенные параметры в клиентской Параметры. Например:
- Группа облачных служб : разрешить клиентам использовать шлюз управления облаками и разрешить доступ к точке распространения облаков
- Группа компьютерного агента : политика выполнения PowerShell
Если устройствам не нужны эти клиентские параметры после завершения последовательности задач, разверните новые настраиваемые параметры клиента, чтобы изменить параметры по умолчанию.
RESETKEYINFORMATIONЕсли у клиента неправильный надежный корневой ключ Диспетчер конфигурации, он не может связаться с доверенным пунктом управления для получения нового доверенного корневого ключа. Используйте это свойство для удаления старого доверенного корневого ключа. Такая ситуация может возникнуть при переходе клиента из одной иерархии сайта в другую. Это свойство применяется к клиентам, которые используют клиентскую связь HTTP и HTTPS. Дополнительные сведения см. в "Планирование надежного корневого ключа".
Пример: CCMSetup.exe RESETKEYINFORMATION=TRUE
SITEREASSIGNВключает автоматическое перенанастраение сайта для обновления клиента при его использования с помощью SMSSITECODE=AUTO.
Пример: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE
SMSCACHEDIRУказывает расположение папки кэша клиента на клиентский компьютер. По умолчанию расположение кэша . %WinDir%\ccmcache
Пример: CCMSetup.exe SMSCACHEDIR="C:\Temp"
Используйте это свойство с свойством SMSCACHEFLAGS для управления расположением папки кэша клиента. Например, установить папку клиентского кэша на самый большой доступный диск клиентского диска: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE
SMSCACHEFLAGSИспользуйте это свойство, чтобы указать дополнительные сведения об установке для папки кэша клиента. Свойства можно использовать SMSCACHEFLAGS по отдельности или в сочетании, разделенных зайколонами ( ; ).
Если вы не включаете это свойство:
- Клиент устанавливает папку кэша в соответствии с свойством SMSCACHEDIR
- Папка не сжата
- Клиент использует свойство в SMSCACHESIZE качестве ограничения размера в МБ кэша
При обновлении существующего клиента установщик клиента игнорирует это свойство.
Значения для SMSCACHEFLAGS свойстваPERCENTDISKSPACE : Установите размер кэша в процентах от общего пространства диска. Если указать это свойство, также установите SMSCACHESIZE процентное значение.
PERCENTFREEDISKSPACE : Установите размер кэша в процентах от свободного пространства диска. Если указать это свойство, также закажите SMSCACHESIZE в качестве процентного значения. Например, диск имеет 10 МБ бесплатно, и вы указываете SMSCACHESIZE=50 . Установщик клиента задает размер кэша до 5 МБ. Вы не можете использовать это свойство с свойством PERCENTDISKSPACE .
MAXDRIVE : Установите кэш на самый большой доступный диск. Если указать путь с свойством SMSCACHEDIR , установщик клиента игнорирует это значение.
MAXDRIVESPACE : Установите кэш на диске с самым свободным пространством. Если указать путь с свойством SMSCACHEDIR , установщик клиента игнорирует это значение.
NTFSONLY . Установите кэш только на диске в формате NTFS. Если указать путь с свойством SMSCACHEDIR , установщик клиента игнорирует это значение.
COMPRESS : Храните кэш в сжатой форме.
FAILIFNOSPACE . Если для установки кэша недостаточно места, удалите клиент Configuration Manager.
Пример: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS
SMSCACHESIZEПараметры клиента доступны для указания размера папки кэша клиента. Добавление этих параметров клиента фактически заменяет использование SMSCACHESIZE в качестве свойства client.msi, чтобы указать размер кэша клиента. Дополнительные сведения см. в параметрах клиента для размера кэша.
При обновлении существующего клиента установщик клиента игнорирует этот параметр. Клиент также игнорирует размер кэша при загрузке обновлений программного обеспечения.
Пример: CCMSetup.exe SMSCACHESIZE=100
Если переустановить клиента, SMSCACHESIZE SMSCACHEFLAGS нельзя использовать или установить размер кэша меньше, чем он был ранее. Предыдущий размер — это минимальное значение.
SMSCONFIGSOURCEИспользуйте это свойство, чтобы указать расположение и заказать, чтобы клиент-установщик проверял параметры конфигурации. Это строка из одного или более символов, каждый из которых определяет определенный источник конфигурации:
R : Проверьте параметры конфигурации в реестре.
P : Проверьте параметры конфигурации в свойствах установки из командной строки.
M : Проверьте существующие параметры при обновлении более старого клиента.
U : Обновление установленного клиента до более новой версии и использование назначенного кода сайта.
По умолчанию клиент-установщик использует PU . Сначала проверяет свойства установки ( P ) и существующие параметры ( U ).
Пример: CCMSetup.exe SMSCONFIGSOURCE=RP
[!IMPORTANT] > WINS is a deprecated service. For more information, see [Windows Internet Name Service (WINS)](/windows-server/networking/technologies/wins/wins-top). Use the **NOWINS** value for this setting. This value is the most secure setting for this property. It prevents clients from finding a management point in WINS. When you use this setting, clients must have an alternative method to locate a management point on the intranet. For example, Active Directory Domain Services or DNS publishing. For more information about this process, see [How clients find site resources and services](../../plan-design/hierarchy/understand-how-clients-find-site-resources-and-services.md). Example: `CCMSetup.exe SMSDIRECTORYLOOKUP=NOWINS` -->
SMSMPУказывает начальную точку управления клиентом Configuration Manager для использования.
Если точка управления принимает только клиентские подключения через HTTPS, применим имя точки управления https:// с .
SMSMPLISTУказывает список точек управления для клиента Configuration Manager для использования. Используйте полуколон ( ; ) в качестве делимитера при указании нескольких точек управления.
Если точка управления принимает только клиентские подключения через HTTPS, применим имя точки управления https:// с .
SMSPUBLICROOTKEYЕсли клиент не может получить надежный корневой ключ Диспетчер конфигурации из служб домена Active Directory, используйте это свойство для указания ключа. Это свойство применяется к клиентам, которые используют связь HTTP и HTTPS. Дополнительные сведения см. в "Планирование надежного корневого ключа".
Пример: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>
Получите значение доверенного корневого ключа сайта из файла mobileclient.tcf на сервере сайта. Дополнительные сведения см. в предварительной подготовке клиента с доверенным корневым ключом с помощью файла.
SMSROOTKEYPATHИспользуйте это свойство для переустановки доверенного корневого ключа Configuration Manager. В нем указывается полный путь и имя файла, который содержит надежный корневой ключ. Это свойство применяется к клиентам, которые используют клиентскую связь HTTP и HTTPS. Дополнительные сведения см. в "Планирование надежного корневого ключа".
Пример: CCMSetup.exe SMSROOTKEYPATH=C:\folder\trk
SMSSIGNCERTУказывает полный путь и имя экспортируемого самозаверяемого сертификата на сервере сайта. Сервер сайта хранит этот сертификат в хранилище сертификатов SMS . Он имеет имя Site Server Субъекта и дружественный сертификат подписи сервера сайта.
Экспорт сертификата без закрытого ключа, безопасное хранение файла и доступ к нему только из защищенного канала.
Пример: CCMSetup.exe /UsePKICert SMSSIGNCERT=C:\folder\smssign.cer
SMSSITECODEЭто свойство указывает сайт Configuration Manager, на который назначается клиент. Это значение может быть кодом сайта из трех символов или словом AUTO . Если указать AUTO или не указать это свойство, клиент пытается определить назначение своего сайта из служб домена Active Directory или из указанной точки управления. Чтобы включить AUTO обновления клиентов, также установите SITEREASSIGN=TRUE.
Если вы также указываете точку управления на основе Интернета с свойством CCMHOSTNAME , не используйте AUTO с SMSSITECODE . Непосредственно назначьте клиенту его сайт, указав код сайта.
Пример: CCMSetup.exe SMSSITECODE=XZY
Значения атрибута для критериев выбора сертификата
Диспетчер конфигурации поддерживает следующие значения атрибутов для критериев выбора сертификата PKI:
Атрибут OID Атрибут Distinguished Name Определение атрибута 0.9.2342.19200300.100.1.25 DC Компонент домена 1.2.840.113549.1.9.1 Электронная или электронная почта адрес электронной почты; 2.5.4.3 CN Общее имя 2.5.4.4 SN Имя субъекта 2.5.4.5 SERIALNUMBER Серийный номер 2.5.4.6 В код страны, 2.5.4.7 L Локальность 2.5.4.8 S или ST Имя штата или провинции 2.5.4.9 STREET Адрес (улица, дом) 2.5.4.10 O Название организации 2.5.4.11 OU Организационный блок 2.5.4.12 T или Title Title 2.5.4.42 G или GN или GivenName Заданное имя 2.5.4.43 I или Initials Initials 2.5.29.17 (без значения) Альтернативное имя subject
Установка push клиента
Если используется метод установки клиентского push-решения, используйте следующие параметры на вкладке Клиент в консоли Configuration Manager: