О параметрах и свойствах установки клиента в Configuration Manager

Применяется к: 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.

Пример: ccmsetup.exe /?

/AllowMetered

Начиная с версии 2006, используйте этот параметр для управления поведением клиента в сети со счетчиками. Этот параметр не принимает значения. Когда вы разрешаете клиентскую связь в сети для ccmsetup, она загружает контент, регистрируется на сайте и скачивает начальную политику. Любое дальнейшее сообщение клиента следует конфигурации параметра клиента из этой политики. Дополнительные сведения см. в дополнительных сведениях о параметрах клиента.

Если переустановить клиента на существующем устройстве, он использует следующий приоритет для определения его конфигурации:

  1. Существующая локализованная клиентская политика
  2. Последняя строка команд, хранимая в Windows реестре
  3. Параметры командной строки ccmsetup

/AlwaysExcludeUpgrade

Этот параметр указывает, будет ли клиент автоматически обновляться при включаемом автоматическом обновлении клиента.

Поддерживаемые значения:

  • TRUE: Клиент не будет автоматически обновляться
  • FALSE: Клиент автоматически обновляется (по умолчанию)

Например:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Дополнительные сведения см. в расширенном клиенте для работы с клиентами.

Примечание

При использовании параметра /AlwaysExcludeUpgrade по-прежнему выполняется автоматическое обновление. Однако, когда CCMSetup запускается для выполнения обновления, он заметит, что параметр /AlwaysExcludeUpgrade был задан и будет входить в журнал следующей строки в ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

После этого CCMSetup немедленно выйдет и не выполнит обновление.

/BITSPriority

Когда устройство скачивает файлы установки клиента через подключение HTTP, используйте этот параметр, чтобы указать приоритет загрузки. Укажите одно из следующих возможных значений:

  • FOREGROUND

  • HIGH

  • NORMAL (по умолчанию)

  • LOW

Пример: 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

/mp

Указывает точку управления исходным кодом для подключений компьютеров. Компьютеры используют эту точку управления, чтобы найти ближайшую точку распространения файлов установки. Если нет точек распространения или компьютеры не могут скачать файлы из точек рассылки через четыре часа, они загружают файлы из указанной точки управления.

Дополнительные сведения о том, как ccmsetup загружает контент, см. в материалах Boundary groups - client installation. В этой статье также содержатся сведения о поведении ccmsetup при использовании параметров /MP и /source.

Важно!

Этот параметр указывает начальную точку управления для компьютеров для поиска источника загрузки и может быть любой точкой управления на любом сайте. Он не назначает клиента указанной точке управления.

Компьютеры загружают файлы через подключение HTTP или HTTPS в зависимости от конфигурации роли системы сайта для клиентских подключений. При настройке загрузки можно также использовать регулирование BITS. Если настроены все точки распространения и точки управления только для подключений клиентов HTTPS, убедитесь, что клиентский компьютер имеет действительный клиентский сертификат.

Параметр командной строки /mp можно указать несколько точки управления. Если компьютер не подключается к первому, он пробует следующий в указанном списке. При указании нескольких точек управления разделять значения по полуколонам.

Если клиент подключается к точке управления с помощью HTTPS, укажите имя FQDN, а не имя компьютера. Значение должно соответствовать объекту субъекта или альтернативного имени субъекта сертификата PKI точки управления. Хотя диспетчер конфигурации поддерживает использование имени компьютера в сертификате для подключений в интрасети, рекомендуется использовать FQDN.

Пример с именем компьютера: ccmsetup.exe /mp:SMSMP01

Пример с FQDN: ccmsetup.exe /mp:smsmp01.contoso.com

Этот параметр также может указывать URL-адрес шлюза облачного управления (CMG). Используйте этот URL-адрес для установки клиента на устройстве, основанном на Интернете. Чтобы получить значение для этого параметра, используйте следующие действия:

  • Создание CMG. Дополнительные сведения см. в перенастройку CMG.

  • В активном клиенте откройте команду Windows PowerShell в качестве администратора.

  • Выполните следующую команду:

    (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
    
  • Приложение 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 () для ; отделить каждое значение.

Примеры:

  • CCMSetup.exe /skipprereq:filename.exe

  • CCMSetup.exe /skipprereq:filename1.exe;filename2.exe

Дополнительные сведения о клиентах см. в Windows клиентских предпосылок.

/source

Указывает расположение загрузки файла. Используйте локальный или unC-путь. Устройство загружает файлы с помощью протокола блока сообщений сервера (SMB). Чтобы использовать /source, Windows учетной записи пользователя для установки клиента требуется чтение разрешений на расположение.

Дополнительные сведения о том, как ccmsetup загружает контент, см. в материалах Boundary groups - client installation. В этой статье также содержатся сведения о поведении ccmsetup при использовании параметров /MP и /source.

Совет

Параметр /source можно использовать несколько раз в командной строке для указания альтернативных местоположений загрузки.

Пример: ccmsetup.exe /source:"\\server\share"

/удалить

С помощью этого параметра можно удалить клиента Configuration Manager. Дополнительные сведения см. в переустановке клиента.

Пример: ccmsetup.exe /uninstall

/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 Error
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. Дополнительные сведения см. в получить ID приложения. Для свойства AADCLIENTAPPID этот ID приложения для типа родного приложения.

Пример: 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 в качестве администратора.

  • Выполните следующую команду:

    (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
    
  • Используйте возвращенное значение как есть с свойством CCMHOSTNAME.

Пример: ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

Важно!

При указании адреса CMG для свойства CCMHOSTNAME не придайте префикс, например https:// . Используйте этот префикс только с URL-адресом CMG.MP.

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

FSP

Укажите точку состояния отката, которая получает и обрабатывает сообщения состояния, отправленные клиентами Configuration Manager.

Дополнительные сведения см. в пункте Определение необходимости точки состояния отката.

Пример: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Если задайте это свойство, клиент-установщик не проверяет минимальную требуемую версию виртуализации TRUE приложений Майкрософт (App-V).

Важно!

Если вы установите клиент Configuration Manager без установки App-V, вы не сможете развернуть виртуальные приложения.

Пример: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

NOTIFYONLY

Когда вы включаете это свойство, клиент сообщает состояние, но не устраняет проблемы, которые он находит.

Пример: CCMSetup.exe NOTIFYONLY=TRUE

Дополнительные сведения см. в дополнительных сведениях о настройке состояния клиента.

PROVISIONTS

Используйте это свойство, чтобы запустить последовательность задач для клиента после успешной регистрации на сайте.

Примечание

Если в последовательности задач устанавливаются обновления программного обеспечения или приложения, клиентам требуется действительный сертификат проверки подлинности клиента. Проверка подлинности маркеров не работает. Дополнительные сведения см. в заметках о выпуске .

Например, вы Windows устройство с Windows автопилотом, автоматически зарегистриройте его в Microsoft Intune, а затем установите клиент Configuration Manager для совместного управления. Если указать этот новый параметр, новый клиент, который был создан, запускает последовательность задач. Этот процесс предоставляет дополнительную гибкость для установки приложений и обновлений программного обеспечения или настройки параметров.

Используйте следующий процесс:

  1. Создайте последовательность задач развертывания без ОС для установки приложений, установки обновлений программного обеспечения и настройки параметров.

  2. Развертывание этой последовательности задач в новой встроенной коллекции All Provisioning Devices. Обратите внимание, например, на ID развертывания последовательности PRI20001 задач.

    Совет

    Цель развертывания может быть либо доступной, либо необходимой. Так как в качестве свойства указывается ИД развертывания, цель не имеет значения.

  3. Установите клиент 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 можно использовать по отдельности или в комбинации, разделенной зайколонами ( ; ).

Если вы не включаете это свойство:

При обновлении существующего клиента установщик клиента игнорирует это свойство.

Значения свойства 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: Проверьте параметры конфигурации в реестре.

    Дополнительные сведения см. в дополнительных сведениях о свойствах установки клиента Provision.

  • P: Проверьте параметры конфигурации в свойствах установки из командной строки.

  • M: Проверьте существующие параметры при обновлении более старого клиента.

  • U: Обновление установленного клиента до более новой версии и использование назначенного кода сайта.

По умолчанию клиент-установщик использует PU . Сначала проверяет свойства установки (), а затем P существующие параметры ( U ).

Пример: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Указывает начальную точку управления клиентом Configuration Manager для использования.

Важно!

Если точка управления принимает только клиентские подключения через HTTPS, применим имя точки управления https:// с .

Примеры:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

  • CCMSetup.exe SMSMP=https://smsmp01.contoso.com

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 . Если указать или не указать это свойство, клиент пытается определить назначение своего сайта из служб домена Active Directory или из указанной AUTO точки управления. Чтобы включить 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: