Бөлісу құралы:

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

  • Мақала

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

Используйте команду 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 и вспомогательные файлы находятся на сервере сайта в папке 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

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

Примечание.

При использовании /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 загружает содержимое, см. в разделе Группы границ — установка клиента. В этой статье также содержатся сведения о поведении 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

Важно!

При указании URL-адреса шлюза управления облаком /mp для параметра он должен начинаться с https://.

Примечание.

Параметр командной строки /mp не указывает точку управления, используемую клиентом Configuration Manager после ее установки. Чтобы указать начальную точку управления, используемую клиентом Configuration Manager после установки, используйте свойство client.msi SMSMP. Чтобы указать список точек управления, которые клиент Configuration Manager будет использовать после установки, используйте свойство client.msi SMSMPLIST.

/NoCRLCheck

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

Пример: 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 не устанавливает указанные необходимые компоненты. Можно ввести несколько значений. Используйте символ с запятой (;) для разделения каждого значения.

Примеры:

  • CCMSetup.exe /skipprereq:filename.exe

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

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

/source

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

Дополнительные сведения о том, как ccmsetup загружает содержимое, см. в разделе Группы границ — установка клиента. В этой статье также содержатся сведения о поведении 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

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

Примечание.

В некоторых сценариях указывать этот параметр не требуется, но по-прежнему используется сертификат клиента. Например, принудительная отправка клиента и установка клиента на основе обновлений программного обеспечения. Используйте этот параметр при установке клиента вручную и использовании /mp параметра с точкой управления с поддержкой HTTPS.

Также укажите этот параметр при установке клиента для обмена данными только через Интернет. Используйте CCMALWAYSINF=1 вместе со свойствами для интернет-точки управления (CCMHOSTNAME) и кода сайта (SMSSITECODE). Дополнительные сведения об управлении клиентами в Интернете см. в разделе Рекомендации по обмену данными между клиентами из Интернета или из ненадежного леса.

/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

Указывает идентификатор 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

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

Важно!

При использовании этого свойства компьютер перезагружается без предупреждения. Это происходит, даже если пользователь вошел в Windows.

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

Совет

Используйте значение атрибута CertificateIssuers в файле mobileclient.tcf для сайта. Этот файл находится во \bin\<platform> вложенной папке каталога установки Configuration Manager на сервере сайта.

Дополнительные сведения о списке издателей сертификатов и о том, как клиенты используют его во время выбора сертификата, см. в разделе Планирование выбора 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.

Важно!

При использовании имени Subject субъекта ключевое слово учитывает регистр, а SubjectStr ключевое слово не учитывает регистр.

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

Полный список атрибутов, которые можно использовать для выбора сертификата, см. в разделе Поддерживаемые значения атрибутов для критериев выбора 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

Важно!

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

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

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

Дополнительные сведения о публикации DNS в качестве метода расположения службы для клиентов Configuration Manager см. в статье Расположение службы и определение клиентами назначенной точки управления.

Примечание.

По умолчанию Configuration Manager не включает публикацию DNS.

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

FSP

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

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

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

IGNOREAPPVVERSIONCHECK

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

Важно!

Если вы устанавливаете клиент Configuration Manager без установки 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.

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

Примечание.

Последовательность задач, запущенная с помощью PROVISIONTS , использует параметры клиента по умолчанию. Эта последовательность задач запускается сразу после регистрации клиента, поэтому она не будет частью какой-либо коллекции, в которой развернуты пользовательские параметры клиента. Клиент не обрабатывает и не применяет пользовательские параметры клиента перед выполнением этой последовательности задач.

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

  • Облачные службы группа: разрешить клиентам использовать шлюз управления облаком и разрешить доступ к облачной точке распространения
  • Группа агентов компьютеров: политика выполнения PowerShell

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

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

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

Важно!

Параметры клиента доступны для указания размера папки кэша клиента. Добавление этих параметров клиента фактически заменяет использование SMSCACHESIZE в качестве свойства client.msi для указания размера кэша клиента. Дополнительные сведения см. в разделе Параметры клиента для размера кэша.

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

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

Примечание.

При переустановке клиента нельзя использовать SMSCACHESIZE или SMSCACHEFLAGS , чтобы задать размер кэша меньше, чем раньше. Предыдущий размер является минимальным значением.

SMSCONFIGSOURCE

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

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

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

  • 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

SMSMPLIST

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

Важно!

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

Примеры:

  • 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>

Совет

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

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.

Примечание.

Если вы также указываете интернет-точку управления со свойством CCMHOSTNAME , не используйте AUTO с SMSSITECODE. Непосредственно назначьте клиент своему сайту, указав код сайта.

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