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

Относится к Configuration Manager (Current Branch)

Используйте команду CCMSetup.exe для установки клиента Configuration Manager. Если в командной строке указать параметры установки клиента, они изменяют поведение установки. Если указать свойства установки клиента в командной строке, они изменяют начальную конфигурацию установленного агента клиента.

О CCMSetup.exe

Команда CCMSetup.exe скачивает необходимые файлы для установки клиента из точки управления или исходного расположения. К этим файлам могут относиться:

• Пакет установщика Windows client.msi, который устанавливает клиентское программное обеспечение

• Предварительные требования для клиента

• Обновления и исправления для клиента Configuration Manager

CCMSetup.exe предоставляет параметры командной строки для настройки установки. Параметры имеют префикс косой черты (/) и обычно имеют нижний регистр. При необходимости вы указываете значение параметра с помощью двоеточия (:), за которым следует значение. Дополнительные сведения см . в разделе параметры командной строкиCCMSetup.exe.

Вы также можете указать свойства в командной строке CCMSetup.exe, чтобы изменить поведение client.msi. Свойства по соглашению имеют верхний регистр. Вы указываете значение для свойства с помощью знака равенства (=), за которым следует значение. Дополнительные сведения см. в разделе свойстваClient.msi.

CCMSetup.exe и вспомогательные файлы находятся на сервере сайта в папке Client папки установки Configuration Manager. 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

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

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

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

/AlwaysExcludeUpgrade

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

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

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

Например:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Дополнительные сведения см. в разделе Клиент расширенного взаимодействия.

/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 не устанавливает центр программного обеспечения на клиенте.

/forceinstall

Укажите, что CCMSetup.exe удаляет любой существующий клиент и устанавливает новый клиент.

/forcereboot

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

Пример: CCMSetup.exe /forcereboot

/logon

Если какая-либо версия клиента уже установлена, этот параметр указывает, что установка клиента должна быть остановлена.

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

/mp

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

Дополнительные сведения о том, как ccmsetup загружает содержимое, см. в разделе Группы границ — установка клиента. В этой статье также содержатся сведения о поведении ccmsetup при использовании /mp параметров и /source .

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

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

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

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

Пример с полным доменным именем: ccmsetup.exe /mp:smsmp01.contoso.com

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

• Создайте шлюз управления облачными клиентами. Дополнительные сведения см. в разделе Настройка 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

/NoCRLCheck

Указывает, что клиент не должен проверка список отзыва сертификатов (CRL) при обмене данными с PKI-сертификатом по протоколу HTTPS. Если этот параметр не указан, клиент проверяет список отзыва сертификатов, прежде чем установить HTTPS-подключение. Дополнительные сведения о проверке списка отзыва сертификатов клиента см. в разделе Планирование отзыва PKI-сертификатов.

Пример: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Этот параметр предотвращает запуск CCMSetup в качестве службы, что он делает по умолчанию. Когда CCMSetup выполняется как служба, она выполняется в контексте учетной записи локальной системы компьютера. Эта учетная запись может не иметь достаточных прав для доступа к необходимым сетевым ресурсам для установки. С /noserviceпомощью CCMSetup.exe выполняется в контексте учетной записи пользователя, используемой для запуска установки.

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

/regtoken

Используйте этот параметр для предоставления маркера массовой регистрации. Интернет-устройство использует этот маркер в процессе регистрации через шлюз управления облаком (CMG). Дополнительные сведения см. в статье Проверка подлинности на основе токенов для CMG.

При использовании этого параметра также включите следующие параметры и свойства:

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

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

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

/retry

Если CCMSetup.exe не удается скачать файлы установки, используйте этот параметр, чтобы указать интервал повтора в минутах. CCMSetup продолжает повторять попытку, пока не достигнет предела, указанного в параметре /downloadtimeout .

Пример: ccmsetup.exe /retry:20

/service

Указывает, что CCMSetup должен выполняться как служба, использующая учетную запись локальной системы.

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

/skipprereq

Этот параметр указывает, что CCMSetup.exe не устанавливает указанные необходимые компоненты. Можно ввести несколько значений. Используйте символ с запятой (;) для разделения каждого значения.

Примеры:

• CCMSetup.exe /skipprereq:filename.exe

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

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

/source

Указывает расположение скачивания файла. Используйте локальный или UNC-путь. Устройство загружает файлы по протоколу SMB. Для использования /sourceучетной записи пользователя Windows для установки клиента требуются разрешения на чтение расположения.

Дополнительные сведения о том, как ccmsetup загружает содержимое, см. в разделе Группы границ — установка клиента. В этой статье также содержатся сведения о поведении ccmsetup при использовании /mp параметров и /source .

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

/uninstall

Используйте этот параметр для удаления клиента Configuration Manager. Дополнительные сведения см. в разделе Удаление клиента.

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

/UsePKICert

Укажите этот параметр, чтобы клиент использовал сертификат проверки подлинности клиента PKI. Если этот параметр не включен или клиент не может найти действительный сертификат, он отфильтрует все точки управления HTTPS, включая шлюзы управления облаком (CMG). Клиент использует HTTP-подключение с самозаверяющий сертификат.

Пример: CCMSetup.exe /UsePKICert

Если устройство использует идентификатор Microsoft Entra для проверки подлинности клиента, а также имеет сертификат проверки подлинности клиента на основе PKI, то при включении этого параметра клиент не сможет получить сведения о подключении Microsoft Entra из шлюза управления облаком (CMG). Для клиента, использующего проверку подлинности Microsoft Entra, не указывайте этот параметр, но включите свойства AADRESOURCEURI и AADCLIENTAPPID.

/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"

свойства Client.msi

Следующие свойства могут изменить поведение установки client.msi, которая ccmsetup.exe устанавливается.

AADCLIENTAPPID

Указывает идентификатор Microsoft Entra клиентского приложения. Вы создаете или импортируете клиентское приложение при настройке служб Azure для управления облаком. Администратор Azure может получить значение этого свойства из портал Azure. Дополнительные сведения см. в разделе Получение идентификатора приложения. AADCLIENTAPPID Для свойства этот идентификатор приложения предназначен для собственного типа приложения.

Пример: ccmsetup.exe AADCLIENTAPPID=aa28e7f1-b88a-43cd-a2e3-f88b257c863b

AADRESOURCEURI

Указывает идентификатор приложения сервера Microsoft Entra. Серверные приложения создаются или импортируются при настройке служб Azure для управления облаком. При создании серверного приложения в окне Создание серверного приложения это свойство является универсальным кодом ресурса (URI) идентификатора приложения.

Администратор Azure может получить значение этого свойства из портал Azure. В Microsoft Entra идентификатор найдите серверные приложения в разделе Регистрация приложений. Найдите тип приложения Веб-приложение или API. Откройте приложение, выберите Параметры, а затем — Свойства. Используйте значение URI идентификатора приложения для этого AADRESOURCEURI свойства установки клиента.

Пример: ccmsetup.exe AADRESOURCEURI=https://contososerver

AADTENANTID

Указывает идентификатор клиента Microsoft Entra. Configuration Manager ссылки на этот клиент при настройке служб Azure для управления облаком. Чтобы получить значение для этого свойства, выполните следующие действия.

• На устройстве, которое работает Windows 10 или более поздней версии и присоединено к тому же Microsoft Entra арендатору, откройте командную строку.

• Выполните следующую команду: dsregcmd.exe /status

• В разделе Состояние устройства найдите значение TenantId . Пример: TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

  Примечание.

  Администратор Azure также может получить это значение в портал Azure. Дополнительные сведения см. в разделе Получение идентификатора клиента.

Пример: ccmsetup.exe AADTENANTID=607b7853-6f6f-4d5d-b3d4-811c33fdd49a

CCMADMINS

Указывает одну или несколько учетных записей или групп пользователей Windows, которые должны получить доступ к параметрам и политикам клиента. Это свойство полезно, если у вас нет учетных данных локального администратора на клиентском компьютере. Укажите список учетных записей, разделенных точкой с запятой (;).

Пример: CCMSetup.exe CCMADMINS="domain\account1;domain\group1"

CCMALLOWSILENTREBOOT

При необходимости разрешите компьютеру автоматически перезагружать после установки клиента.

Пример: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Чтобы указать, что клиент всегда находится в Интернете и никогда не подключается к интрасети, задайте для этого свойства значение 1. Тип подключения клиента отображает Always Internet.

Используйте это свойство с CCMHOSTNAME , чтобы указать полное доменное имя интернет-точки управления. Также используйте его с параметром CCMSetup UsePKICert и свойством SMSSITECODE .

Дополнительные сведения об управлении клиентами в Интернете см. в разделе Рекомендации по обмену данными между клиентами из Интернета или из ненадежного леса.

Пример: CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC

CCMCERTISSUERS

Используйте это свойство для указания списка издателей сертификатов. Этот список содержит сведения о сертификатах для доверенных корневых центров сертификации (ЦС), которым доверяет Configuration Manager сайт.

Это значение соответствует регистру атрибутов субъекта, которые находятся в корневом сертификате ЦС. Разделяйте атрибуты запятой (,) или точкой с запятой (;). Укажите несколько корневых сертификатов ЦС с помощью строки разделителя (|).

Пример: CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."

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

CCMCERTNAMECHECK

Начиная с версии 2207 это свойство можно использовать для пропуска проверки имени субъекта для сертификата. CCMCERTNAMECHECK=0 пропускает проверку имени субъекта сертификата.

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.

Полный список атрибутов, которые можно использовать для выбора сертификата, см. в разделе Поддерживаемые значения атрибутов для критериев выбора PKI-сертификатов.

Если поиску соответствует несколько сертификатов, а для параметра задано 1значение CCMFIRSTCERT , клиентский установщик выбирает сертификат с самым длительным сроком действия.

CCMCERTSTORE

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

Пример: CCMSetup.exe /UsePKICert CCMCERTSTORE="ConfigMgr"

CCMDEBUGLOGGING

Это свойство включает ведение журнала отладки при установке клиента. Это свойство заставляет клиента регистрировать низкоуровневые сведения для устранения неполадок. Избегайте использования этого свойства на рабочих сайтах. Может возникать чрезмерное ведение журнала, что может затруднить поиск соответствующей информации в файлах журнала. Также включите .CCMENABLELOGGING

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

• 0: отключение ведения журнала отладки (по умолчанию)
• 1: включение ведения журнала отладки

Пример: CCMSetup.exe CCMDEBUGLOGGING=1

Дополнительные сведения см. в разделе Сведения о файлах журнала.

CCMENABLELOGGING

Configuration Manager включает ведение журнала по умолчанию.

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

• TRUE: включение ведения журнала (по умолчанию)
• FALSE: отключение ведения журнала

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

Дополнительные сведения см. в разделе Сведения о файлах журнала.

CCMEVALINTERVAL

Частота в минутах, с которой запускается средство оценки работоспособности клиента (ccmeval.exe). Укажите целочисленное значение от 1 до 1440. По умолчанию ccmeval выполняется один раз в день (1440 минут).

Пример: CCMSetup.exe CCMEVALINTERVAL=1440

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

CCMEVALHOUR

Час в течение дня, когда запускается средство оценки работоспособности клиента (ccmeval.exe). Укажите целочисленное значение от 0 (полуночи) до 23 (23:00). По умолчанию ccmeval выполняется в полночь.

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

CCMFIRSTCERT

Если для этого свойства задано значение 1, клиент выбирает PKI-сертификат с самым длительным сроком действия.

Пример: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Если клиент управляется через Интернет, это свойство указывает полное доменное имя интернет-точки управления.

Не указывайте этот параметр со свойством SMSSITECODE=AUTOустановки . Непосредственно назначьте интернет-клиенты интернет-сайту.

Пример: CCMSetup.exe /UsePKICert CCMHOSTNAME="SMSMP01.corp.contoso.com"

Это свойство может указывать адрес шлюза управления облаком (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

CCMHTTPPORT

Указывает порт, используемый клиентом при обмене данными с серверами системы сайта по протоколу HTTP. По умолчанию это значение равно 80.

Пример: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Указывает порт, используемый клиентом при обмене данными с серверами системы сайта по протоколу HTTPS. По умолчанию это значение равно 443.

Пример: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Используйте это свойство, чтобы задать папку для установки Configuration Manager клиентских файлов. По умолчанию используется %WinDir%\CCM.

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

Это свойство задает максимальный размер файла журнала в байтах. Когда журнал увеличивается до указанного размера, клиент переименовывает его как файл журнала и создает новый. Размер по умолчанию — 250 000 байт, а минимальный размер — 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 в качестве метода расположения службы для клиентов Configuration Manager см. в статье Расположение службы и определение клиентами назначенной точки управления.

Пример: CCMSetup.exe SMSSITECODE=ABC DNSSUFFIX=contoso.com

FSP

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

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

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

IGNOREAPPVVERSIONCHECK

Если для этого свойства задано значение TRUE, клиентский установщик не проверка минимальную требуемую версию Microsoft Application Virtualization (App-V).

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

MANAGEDINSTALLER

Если для этого свойства задано значение , 1 ccmsetup.exe и client.msi будут настроены как управляемые установщики. Дополнительные сведения см. в статье Автоматическое разрешение приложений, развернутых управляемым установщиком с помощью Защитник Windows управления приложениями.

Пример: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

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

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

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

PROVISIONTS

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

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

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

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

2. Разверните эту последовательность задач в новой встроенной коллекции Все устройства подготовки. Обратите внимание на идентификатор развертывания последовательности задач, например PRI20001.

   Совет

   Назначение развертывания может быть доступным или обязательным. Так как идентификатор развертывания указан в качестве значения свойства, назначение не имеет значения.

3. Установите клиент Configuration Manager на устройстве с помощью ccmsetup.msiи включите следующее свойство: PROVISIONTS=PRI20001. Задайте значение этого свойства в качестве идентификатора развертывания последовательности задач.

   • Если вы устанавливаете клиент из Intune во время регистрации совместного управления, см. статью Подготовка интернет-устройств к совместному управлению.

     Примечание.

     Этот метод может иметь дополнительные предварительные требования. Например, регистрация сайта для Microsoft Entra идентификатора или создание шлюза управления облачными клиентами с поддержкой содержимого.

     Независимо от метода, используйте это свойство только с ccmsetup.msi.

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

RESETKEYINFORMATION

Если у клиента есть неправильный Configuration Manager доверенный корневой ключ, он не может связаться с доверенной точкой управления, чтобы получить новый доверенный корневой ключ. Используйте это свойство для удаления старого доверенного корневого ключа. Такая ситуация может возникнуть при перемещении клиента из одной иерархии сайта в другую. Это свойство применяется к клиентам, которые используют обмен данными между клиентами 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

При обновлении существующего клиента установщик клиента игнорирует этот параметр. Клиент также игнорирует размер кэша при скачивании обновлений программного обеспечения.

Пример: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Используйте это свойство, чтобы указать расположение и порядок, которые установщик клиента проверяет на наличие параметров конфигурации. Это строка из одного или нескольких символов, каждый из которых определяет конкретный источник конфигурации:

• R: проверьте параметры конфигурации в реестре.

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

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

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

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

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

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

SMSMP

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

Примеры:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Указывает список точек управления для клиента Configuration Manager. Используйте точку с запятой (;) в качестве разделителя при указании нескольких точек управления.

Примеры:

• CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;https://smsmp02.contoso.com;smsmp03.contoso.com

• CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;smsmp02.contoso.com;smsmp03.contoso.com

SMSPUBLICROOTKEY

Если клиенту не удается получить Configuration Manager доверенный корневой ключ из доменные службы Active Directory, используйте это свойство, чтобы указать ключ. Это свойство применяется к клиентам, которые используют обмен данными по протоколам HTTP и HTTPS. Дополнительные сведения см. в разделе Планирование доверенного корневого ключа.

Пример: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Используйте это свойство, чтобы переустановить Configuration Manager доверенный корневой ключ. Он задает полный путь и имя файла, содержащего доверенный корневой ключ. Это свойство применяется к клиентам, которые используют обмен данными между клиентами HTTP и HTTPS. Дополнительные сведения см. в разделе Планирование доверенного корневого ключа.

Пример: CCMSetup.exe SMSROOTKEYPATH=C:\folder\trk

SMSSIGNCERT

Указывает полный путь и имя экспортированного самозаверяющего сертификата на сервере сайта. Сервер сайта хранит этот сертификат в хранилище сертификатов SMS . У него есть имя субъекта Сервер сайта и понятное имя Сертификат подписи сервера сайта.

Экспорт сертификата без закрытого ключа, безопасное хранение файла и доступ к нему только из защищенного канала.

Пример: CCMSetup.exe /UsePKICert SMSSIGNCERT=C:\folder\smssign.cer

SMSSITECODE

Это свойство указывает сайт Configuration Manager, которому назначается клиент. Это значение может быть трехзначным кодом сайта или словом AUTO. Если указать AUTOили не указать это свойство, клиент пытается определить назначение сайта из доменные службы Active Directory или из указанной точки управления. Чтобы включить AUTO обновление клиента, также установите параметр SITEREASSIGN=TRUE.

Пример: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Это свойство заставляет CCMSetup отправлять запрос на расположение в точку управления, чтобы получить последнюю версию источника установки клиента Configuration Manager. Существует несколько сценариев, в которых это свойство особенно полезно:

• Предварительные клиенты. Только что установленный клиент использует рабочую базовую конфигурацию, так как он не может оценить предварительную коллекцию, пока клиент не будет установлен. В этом сценарии после установки клиента и оценки политики он будет обновлен до предварительной версии клиента. Используйте это свойство, чтобы устройство немедленно установило последнюю версию клиента.

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

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

Значения атрибутов для условий выбора сертификата

Configuration Manager поддерживает следующие значения атрибутов для критериев выбора сертификата PKI:

Атрибут OID	Атрибут Различающееся имя	Определение атрибута
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	УЛИЦЕ	Адрес (улица, дом)
2.5.4.10	O	Название организации
2.5.4.11	ПОДРАЗДЕЛЕНИЕ	Подразделения
2.5.4.12	T или заголовок	Название
2.5.4.42	G, GN или GivenName	Заданное имя
2.5.4.43	I или Initials	Инициалы
2.5.29.17	(без значения)	Альтернативное имя субъекта

Принудительная установка клиента

Если используется метод принудительной установки клиента, используйте следующие параметры на вкладке Клиентсвойства принудительной установки клиента в консоли Configuration Manager:

• Любое из свойствClient.msi

• Для принудительной отправки клиента разрешено следующее подмножество параметровCCMSetup.exe командной строки :

  • /AllowMetered (начиная с версии 2103)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert