Сведения о параметрах и свойствах установки клиента в Configuration ManagerAbout client installation parameters and properties in Configuration Manager

Область применения: Configuration Manager (Current Branch)Applies to: Configuration Manager (current branch)

Для установки клиента Configuration Manager используется команда CCMSetup.exe.Use the CCMSetup.exe command to install the Configuration Manager client. Если указать параметры установки клиента в командной строке, они изменят режим установки.If you provide client installation parameters on the command line, they modify the installation behavior. Если указать свойства установки клиента в командной строке, они изменят начальную конфигурацию установленного агента клиента.If you provide client installation properties on the command line, they modify the initial configuration of the installed client agent.

О файле CCMSetup.exeAbout CCMSetup.exe

Программа CCMSetup.exe скачивает файлы, необходимые для установки клиента, из точки управления или исходного расположения.The CCMSetup.exe command downloads needed files to install the client from a management point or a source location. Эти файлы могут содержать следующее:These files might include:

  • пакет установщика Windows client.msi, который устанавливает программное обеспечение клиента;The Windows Installer package client.msi that installs the client software

  • Требования к клиентуClient prerequisites

  • обновления и исправления для клиента Configuration Manager.Updates and fixes for the Configuration Manager client

Примечание

Установить файл client.msi напрямую не удастся.You can't directly install client.msi.

CCMSetup.exe поддерживает параметры командной строки для настройки установки.CCMSetup.exe provides command-line parameters to customize the installation. Параметры начинаются с косой черты (/) и обычно указываются в нижнем регистре.Parameters are prefixed with a slash (/) and are generally lower case. Чтобы задать значение параметра, поставьте после параметра двоеточие (:) и укажите значение.You specify the value of a parameter when necessary using a colon (:) immediately followed by the value. Дополнительные сведения см. в статье Параметры командной строки CCMSetup.exe.For more information, see CCMSetup.exe command-line parameters.

Кроме того, в командной строке CCMSetup.exe можно указать свойства для изменения поведения client.msi.You can also supply properties at the CCMSetup.exe command line to modify the behavior of client.msi. По соглашению свойства указываются в верхнем регистре.Properties by convention are upper case. Чтобы задать значение для свойства, после него нужно поставить знак равенства (=) и указать значение.You specify a value for a property using an equal sign (=) immediately followed by the value. Дополнительные сведения см. в разделе Свойства Client.msi.For more information, see Client.msi properties.

Важно!

Укажите параметры CCMSetup, прежде чем указывать свойства для client.msi.Specify CCMSetup parameters before you specify properties for client.msi.

CCMSetup.exe и файлы поддержки находятся на сервере сайта Configuration Manager в папке Client папки установки Configuration Manager.CCMSetup.exe and the supporting files are on the site server in the Client folder of the Configuration Manager installation folder. Configuration Manager предоставляет общий доступ к этой папке по сети на общем ресурсе сайта.Configuration Manager shares this folder to the network under the site share. Например, \\SiteServer\SMS_ABC\Client.For example, \\SiteServer\SMS_ABC\Client.

В командной строке команда CCMSetup.exe используется в следующем формате.At the command prompt, the CCMSetup.exe command uses the following format:

CCMSetup.exe [<Ccmsetup parameters>] [<client.msi setup properties>]

Пример.For example:

CCMSetup.exe /mp:SMSMP01 /logon SMSSITECODE=S01 FSP=SMSFSP01

В этом примере команда выполняет следующие действия:This example does the following things:

  • задает точку управления с именем SMSMP01, чтобы запросить список точек распространения для скачивания установочных файлов клиента;Specifies the management point named SMSMP01 to request a list of distribution points to download the client installation files.

  • указывает, что установка должна прекратиться, если на компьютере уже существует версия клиента;Specifies that installation should stop if a version of the client already exists on the computer.

  • Указывает, что client.msi должен назначить клиента сайту с кодом S01.Instructs client.msi to assign the client to the site code S01.

  • Указывает, что client.msi должен использовать резервную точку состояния с именем SMSFP01.Instructs client.msi to use the fallback status point named SMSFP01.

Совет

Если параметр содержит пробелы, заключите его в кавычки.If a parameter value has spaces, surround it with quotation marks.

Если схема Active Directory расширена для Configuration Manager, сайт публикует многие свойства установки клиента в доменных службах Active Directory.If you extend the Active Directory schema for Configuration Manager, the site publishes many client installation properties in Active Directory Domain Services. Клиент Configuration Manager автоматически считывает эти свойства.The Configuration Manager client automatically reads these properties. Дополнительные сведения см. в статье О свойствах установки клиента, публикуемых в доменных службах Active Directory.For more information, see About client installation properties published to Active Directory Domain Services

Параметры командной строки CCMSetup.exeCCMSetup.exe command-line parameters

/?/?

Отображает доступные параметры командной строки для ccmsetup.exe.Shows available command-line parameters for ccmsetup.exe.

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

/AllowMetered/AllowMetered

Начиная с версии 2006 вы можете использовать этот параметр для управления поведением клиента в сети с лимитным тарифным планом.Starting in version 2006, use this parameter to control the client's behavior on a metered network. Этот параметр не может принимать значения.This parameter takes no values. Если для ccmsetup разрешен обмен данными между клиентами в сети с лимитным тарифным планом, клиент загружает содержимое, регистрируется на сайте и загружает исходную политику.When you allow client communication on a metered network for ccmsetup, it downloads the content, registers with the site, and downloads the initial policy. Далее обмен данными между клиентами осуществляется в соответствии с конфигурацией клиента, заявленной в данной политике.Any further client communication follows the configuration of the client setting from that policy. Дополнительные сведения см. в разделе Сведения о параметрах клиентов.For more information, see About client settings.

При переустановке клиента на существующем устройстве для определения его конфигурации используется следующий приоритет:If you reinstall the client on an existing device, it uses the following priority to determine its configuration:

  1. Существующая политика локального клиентаExisting local client policy
  2. Последняя командная строка, сохраненная в реестре WindowsThe last command line stored in the Windows registry
  3. Параметры в командной строке ccmsetupParameters on the ccmsetup command line

/AlwaysExcludeUpgrade/AlwaysExcludeUpgrade

Этот параметр определяет, будет ли клиент автоматически обновляться при включении параметра Автоматическое обновление клиента.This parameter specifies whether or not a client will auto upgrade when you enable Automatic client upgrade.

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

  • TRUE: клиент не будет обновляться автоматически.TRUE: The client won't automatically upgrade
  • FALSE: клиент будет обновляться автоматически (по умолчанию).FALSE: The client automatically upgrades (default)

Пример.For example:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Дополнительные сведения см. в статье Использование клиентского программного обеспечения Configuration Manager для расширения взаимодействия с будущими версиями сайта Current Branch.For more information, see Extended interoperability client.

Примечание

При использовании параметра /AlwaysExcludeUpgrade автоматическое обновление по-прежнему будет выполняться.When using the /AlwaysExcludeUpgrade parameter, the auto upgrade still runs. Но при запуске CCMSetup для выполнения обновления будет определено, что параметр /AlwaysExcludeUpgrade установлен, и следующая строка будет записана в файл ccmsetup.log.However when CCMSetup runs to perform the upgrade, it will note that /AlwaysExcludeUpgrade parameter has been set and will log the following line in the ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

После этого CCMSetup немедленно завершит работу, а обновление не будет выполнено.CCMSetup will then immediately exit and not perform the upgrade.

/BITSPriority/BITSPriority

Когда устройство скачивает файлы установки клиента по протоколу HTTP, используйте этот параметр, чтобы указать приоритет загрузки.When the device downloads client installation files over an HTTP connection, use this parameter to specify the download priority. Можно указать одно из следующих значений.Specify one of the following possible values:

  • FOREGROUND

  • HIGH

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

  • LOW

Пример: ccmsetup.exe /BITSPriority:HIGHExample: ccmsetup.exe /BITSPriority:HIGH

/config/config

Этот параметр задает имя текстового файла, содержащего свойства установки клиента.This parameter specifies a text file that lists client installation properties.

  • Если CCMSetup выполняется как служба, поместите этот файл в системную папку CCMSetup: %Windir%\Ccmsetup.If CCMSetup runs as a service, place this file in the CCMSetup system folder: %Windir%\Ccmsetup.

  • Если указан параметр /noservice, поместите этот файл в ту же папку, что и CCMSetup.exe.If you specify the /noservice parameter, place this file in the same folder as CCMSetup.exe.

Пример: CCMSetup.exe /config:"configuration file name.txt"Example: CCMSetup.exe /config:"configuration file name.txt"

Для задания правильного формата файла используйте файл mobileclienttemplate.tcf в папке \bin\<platform> каталога установки Configuration Manager на компьютере сервера сайта.To provide the correct file format, use the mobileclienttemplate.tcf file in the \bin\<platform> folder in the Configuration Manager installation directory on the site server. В этом файле содержатся примечания о разделах и их использовании.This file has comments about the sections and how to use them. Укажите свойства установки клиента в разделе [Client Install] после следующего текста: Install=INSTALL=ALL.Specify the client installation properties in the [Client Install] section, after the following text: Install=INSTALL=ALL.

Пример записи в разделе [Client Install]: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100Example [Client Install] section entry: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout/downloadtimeout

Если CCMSetup не удается загрузить файлы установки клиента, этот параметр указывает максимальное время ожидания в минутах.If CCMSetup fails to download the client installation files, this parameter specifies the maximum timeout in minutes. По истечении этого времени CCMSetup прекращает попытки загрузить файлы установки.After this timeout, CCMSetup stops trying to download the installation files. Значение по умолчанию — 1440 минут (один день).The default value is 1440 minutes (one day).

Используйте параметр /retry, чтобы указать интервал между повторными попытками.Use the /retry parameter to specify the interval between retry attempts.

Пример: ccmsetup.exe /downloadtimeout:100Example: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures/ExcludeFeatures

Этот параметр указывает, что программа CCMSetup.exe не устанавливает указанный компонент.This parameter specifies that CCMSetup.exe doesn't install the specified feature.

Пример: CCMSetup.exe /ExcludeFeatures:ClientUI не устанавливает центр программного обеспечения на клиенте.Example: CCMSetup.exe /ExcludeFeatures:ClientUI doesn't install Software Center on the client.

Примечание

Единственным поддерживаемым для параметра /ExcludeFeatures значением является ClientUI.ClientUI is the only value that the /ExcludeFeatures parameter supports.

/forceinstall/forceinstall

Укажите, что CCMSetup.exe удаляет существующий клиент и устанавливает новый.Specify that CCMSetup.exe uninstalls any existing client, and installs a new client.

/forcereboot/forcereboot

Этот параметр используется для принудительной перезагрузки компьютера, если это необходимо для завершения установки.Use this parameter to force the computer to restart if necessary to complete the installation. Если не указать этот параметр, CCMSetup завершит работу, когда потребуется перезагрузка.If you don't specify this parameter, CCMSetup exits when a restart is necessary. Затем программа продолжит работу после следующего перезапуска вручную.It then continues after the next manual restart.

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

/logon/logon

Если уже установлена любая версия клиента, этот параметр указывает, что установка клиента должна прекратиться.If any version of the client is already installed, this parameter specifies that the client installation should stop.

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

/mp/mp

Указывает исходную точку управления, к которой должны подключаться компьютеры.Specifies a source management point for computers to connect to. Компьютеры используют эту точку управления для поиска ближайшей точки распространения для файлов установки.Computers use this management point to find the nearest distribution point for the installation files. Если точки распространения отсутствуют или компьютеры не могут скачать файлы с точек распространения за 4 часа, они скачивают файлы из указанной точки управления.If there are no distribution points, or computers can't download the files from the distribution points after four hours, they download the files from the specified management point.

Дополнительные сведения о том, как установщик клиента скачивает содержимое, см. в статье Настройка групп границ для Configuration Manager.For more information on how ccmsetup downloads content, see Boundary groups - client installation. В этой статье также описаны действия установщика, если указаны оба параметра — /mp и /source.That article also includes details of ccmsetup behavior if you use both /mp and /source parameters.

Важно!

Этот параметр служит для указания начальной точки управления, с помощью которой компьютеры находят источник скачивания. Это может быть любая точка управления на любом сайте.This parameter specifies an initial management point for computers to find a download source, and can be any management point in any site. Он не назначает клиент указанной точке управления.It doesn't assign the client to the specified management point.

Компьютеры загружают файлы через соединение по протоколу HTTP или HTTPS в зависимости от конфигурации ролей системы сайта для подключений клиентов.Computers download the files over an HTTP or HTTPS connection, depending on the site system role configuration for client connections. При настройке можно также использовать регулирование BITS.The download can also use BITS throttling if you configure it. Если все точки распространения и управления настроены только для подключения клиентов по протоколу HTTPS, убедитесь в том, что у клиентского компьютера есть действительный сертификат клиента.If you configure all distribution points and management points for HTTPS client connections only, verify that the client computer has a valid client certificate.

С помощью параметра командной строки /mp можно указать несколько точек управления.You can use the /mp command-line parameter to specify more than one management point. Если компьютеру не удается подключиться к первой точке, он пытается подключиться к следующей в указанном списке.If the computer fails to connect to the first one, it tries the next in the specified list. При указании нескольких точек управления следует разделять значения точками с запятыми.When you specify multiple management points, separate the values by semicolons.

Если клиент подключается к точке управления, используя HTTPS, укажите полное доменное имя вместо имени компьютера.If the client connects to a management point using HTTPS, specify the FQDN not the computer name. Задаваемое значение должно соответствовать имени субъекта или альтернативному имени субъекта в PKI-сертификате точки управления.The value must match the management point PKI certificate's Subject or Subject Alternative Name. Хотя Configuration Manager поддерживает использование имени компьютера в сертификате для подключений в интрасети, рекомендуется использовать полное доменное имя.Although Configuration Manager supports using a computer name in the certificate for connections on the intranet, using an FQDN is recommended.

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

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

Этот параметр также может указывать URL-адрес шлюза управления облачными клиентами (CMG).This parameter can also specify the URL of a cloud management gateway (CMG). Используйте этот URL-адрес для установки клиента на интернет-устройстве.Use this URL to install the client on an internet-based device. Чтобы получить значение этого параметра, выполните следующие действия.To get the value for this parameter, use the following steps:

  • Создайте CMG.Create a CMG. Дополнительные сведения см. в разделе Настройка CMG.For more information, see Set up a CMG.

  • На активном клиенте откройте командную строку Windows PowerShell с правами администратора.On an active client, open a Windows PowerShell command prompt as an administrator.

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

    (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
    
  • Добавьте префикс https:// для использования с параметром /mp.Append the https:// prefix to use with the /mp parameter.

Пример использования URL-адреса шлюза управления облачными клиентами: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100Example for when you use the cloud management gateway URL: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

Важно!

Указываемый URL-адрес шлюза управления облачными клиентами для параметра /mp должен начинаться с https://.When specifying the URL of a cloud management gateway for the /mp parameter, it must start with https://.

/NoCRLCheck/NoCRLCheck

Указывает, что клиент не должен проверять список отзыва сертификатов при соединении по протоколу HTTPS с использованием PKI-сертификата.Specifies that a client shouldn't check the certificate revocation list (CRL) when it communicates over HTTPS with a PKI certificate. Если этот параметр не указан, клиент проверяет список отзыва сертификатов, прежде чем он установит HTTPS-соединение.When you don't specify this parameter, the client checks the CRL before it establishes an HTTPS connection. Дополнительные сведения о проверке списка отзыва сертификатов см. в статье Планирование отзыва PKI-сертификата.For more information about client CRL checking, see Planning for PKI certificate revocation.

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

/noservice/noservice

Данный параметр запрещает запуск CCMSetup в качестве службы (поведение по умолчанию).This parameter prevents CCMSetup from running as a service, which it does by default. Когда программа CCMSetup запускается в качестве службы, она выполняется в контексте учетной записи Local System компьютера.When CCMSetup runs as a service, it runs in the context of the Local System account of the computer. Эта учетная запись может не иметь достаточных прав на доступ к требуемым ресурсам сети для установки.This account might not have sufficient rights to access required network resources for the installation. При указании параметра /noservice CCMSetup.exe выполняется в контексте учетной записи пользователя, применяемой для запуска установки.With /noservice, CCMSetup.exe runs in the context of the user account that you use to start the installation.

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

/regtoken/regtoken

Начиная с версии 2002, этот параметр используется для предоставления токена массовой регистрации.Starting in version 2002, use this parameter to provide a bulk registration token. Интернет-устройство использует этот токен в процессе регистрации через шлюз управления облачными клиентами (CMG).An internet-based device uses this token in the registration process through a cloud management gateway (CMG). Дополнительные сведения см. в разделе Маркеры проверки подлинности в шлюзе управления облачными клиентами.For more information, see Token-based authentication for CMG.

При использовании этого параметра также следует включить следующие параметры и свойства.When you use this parameter, also include the following parameters and properties:

В следующем примере в командной строке имеются другие обязательные параметры и свойства установки:The following example command line includes the other required setup parameters and properties:

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

Если CCMSetup.exe не удается загрузить файлы установки, укажите интервал повторных попыток в минутах.If CCMSetup.exe fails to download installation files, use this parameter to specify the retry interval in minutes. CCMSetup продолжит попытки, пока не достигнет предела, указанного в параметре /downloadtimeout.CCMSetup continues to retry until it reaches the limit specified in the /downloadtimeout parameter.

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

/service/service

Указывает, что CCMSetup нужно запустить в качестве службы, которая использует локальную системную учетную запись.Specifies that CCMSetup should run as a service that uses the Local System account.

Совет

Если вы используете скрипт для запуска CCMSetup.exe с параметром /service, CCMSetup.exe завершает работу после запуска службыIf you're using a script to run CCMSetup.exe with the /service parameter, CCMSetup.exe exits after the service starts. и может неправильно сообщить скрипту о ходе установки.It might not correctly report installation details to the script.

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

/skipprereq/skipprereq

Этот параметр указывает, что программа CCMSetup.exe не устанавливает указанный необходимый компонент.This parameter specifies that CCMSetup.exe doesn't install the specified prerequisite. Можно ввести несколько значений.You can enter more than one value. Используйте символ точки с запятой (;) для разделения значений.Use the semicolon character (;) to separate each value.

Примеры:Examples:

  • CCMSetup.exe /skipprereq:filename.exe

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

Дополнительные сведения о предварительных требованиях для клиента см. в разделе Предварительные требования к клиенту Windows.For more information on client prerequisites, see Windows client prerequisites.

/source/source

Указывает, откуда скачивать файлы.Specifies the file download location. Укажите локальный путь или UNC-путь.Use a local or UNC path. Для скачивания файлов используется протокол SMB.The device downloads files using the server message block (SMB) protocol. Чтобы использовать параметр /source, учетной записи пользователя Windows, используемой для установки клиента, требуются разрешения на чтение для указанного расположения.To use /source, the Windows user account for client installation needs Read permissions to the location.

Дополнительные сведения о том, как установщик клиента скачивает содержимое, см. в статье Настройка групп границ для Configuration Manager.For more information on how ccmsetup downloads content, see Boundary groups - client installation. В этой статье также описаны действия установщика, если указаны оба параметра — /mp и /source.That article also includes details of ccmsetup behavior if you use both /mp and /source parameters.

Совет

Параметр /source можно использовать в командной строке несколько раз, чтобы указать альтернативные источники скачивания.You can use the /source parameter more than once in a command line to specify alternative download locations.

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

/uninstall/uninstall

Используйте этот параметр, чтобы удалить клиент Configuration Manager.Use this parameter to uninstall the Configuration Manager client. Дополнительные сведения см. в разделе Удаление клиента.For more information, see Uninstall the client.

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

/UsePKICert/UsePKICert

Укажите этот параметр, чтобы клиент использовал сертификат проверки подлинности клиента PKI.Specify this parameter for the client to use a PKI client authentication certificate. Если этот параметр не указан или если клиенту не удается найти допустимый сертификат, он использует HTTP-соединение с самозаверяющим сертификатом.If you don't include this parameter, or if the client can't find a valid certificate, it uses an HTTP connection with a self-signed certificate.

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

Примечание

В некоторых ситуациях не требуется указывать этот параметр, однако сертификат клиента по-прежнему используется.In some scenarios, you don't have to specify this parameter, but still use a client certificate. Например, принудительная установка клиента и установка клиента в рамках обновления программного обеспечения.For example, client push and software update–based client installation. Используйте этот параметр при установке клиента вручную и используйте параметр /mp с точкой управления с поддержкой протокола HTTPS.Use this parameter when you manually install a client and use the /mp parameter with an HTTPS-enabled management point.

Также этот параметр необходимо указывать при установке клиента для обмена данными только через Интернет.Also specify this parameter when you install a client for internet-only communication. Используйте свойство CCMALWAYSINF=1 вместе со свойствами интернет-точки управления (CCMHOSTNAME) и кода сайта (SMSSITECODE).Use the CCMALWAYSINF=1 property together with the properties for the internet-based management point (CCMHOSTNAME) and the site code (SMSSITECODE). Дополнительные сведения об управлении клиентами через Интернет см. в разделе Рекомендации по взаимодействию с клиентами из Интернета или недоверенного леса.For more information about internet-based client management, see Considerations for client communications from the internet or an untrusted forest.

Коды возврата CCMSetup.exeCCMSetup.exe return codes

Программа CCMSetup.exe предоставляет указанные ниже коды возврата.The CCMSetup.exe command provides the following return codes. Для устранения неполадок обратитесь к файлу %WinDir%\ccmsetup\ccmsetup.log на клиенте, чтобы определить контекст и получить дополнительные сведения о кодах возврата.To troubleshoot, review %WinDir%\ccmsetup\ccmsetup.log on the client for context and additional detail about return codes.

Код возвратаReturn code ЗначениеMeaning
00 УспехSuccess
66 ОшибкаError
77 Требуется перезагрузкаReboot required
88 Программа установка уже выполняетсяSetup already running
99 Сбой оценки готовности к установкеPrerequisite evaluation failure
1010 Сбой проверки хэша манифеста программой установкиSetup manifest hash validation failure

Свойства ccmsetup.msiCcmsetup.msi properties

Следующие свойства могут изменять режим установки ccmsetup.msi.The following properties can modify the installation behavior of ccmsetup.msi.

CCMSETUPCMDCCMSETUPCMD

Используйте это свойство ccmsetup.msi для передачи дополнительных параметров и свойств командной строки в ccmsetup.exe.Use this ccmsetup.msi property to pass additional command-line parameters and properties to ccmsetup.exe. Другие параметры и свойства необходимо указывать в кавычках (").Include other parameters and properties inside quotation marks ("). Это свойство используется при начальной загрузке клиента Configuration Manager с использованием режима установки Intune MDM.Use this property when you bootstrap the Configuration Manager client with the Intune MDM installation method.

Пример: ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"Example: ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"

Совет

Максимальная длина командной строки в Майкрософт составляет 1024 символа.Microsoft Intune limits the command line to 1024 characters.

Свойства client.msiClient.msi properties

Следующие свойства могут изменять режим установки client.msi, который устанавливается ccmsetup.exe.The following properties can modify the installation behavior of client.msi, which ccmsetup.exe installs. При использовании метода принудительной установки клиента эти параметры можно также указать на вкладке Клиент диалогового окна Свойства принудительной установки клиента в консоли Configuration Manager.If you use the client push installation method, specify these properties on the Client tab of the Client Push Installation Properties in the Configuration Manager console.

AADCLIENTAPPIDAADCLIENTAPPID

Указывает идентификатор клиентского приложения Azure Active Directory (Azure AD).Specifies the Azure Active Directory (Azure AD) client app identifier. Клиентское приложение создается или импортируется при настройке служб Azure для управления облачными клиентами.You create or import the client app when you configure Azure services for Cloud Management. Администратор Azure может получить значение этого свойства на портале Azure.An Azure administrator can get the value for this property from the Azure portal. Дополнительные сведения см. в разделе о получении идентификатора приложения.For more information, see get application ID. Для свойства AADCLIENTAPPID этот идентификатор приложения задан для типа приложения Собственное.For the AADCLIENTAPPID property, this application ID is for the Native application type.

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

AADRESOURCEURIAADRESOURCEURI

Указывает идентификатор серверного приложения Azure AD.Specifies the Azure AD server app identifier. Серверное приложение создается или импортируется при настройке служб Azure для управления облачными клиентами.You create or import the server app when you configure Azure services for Cloud Management. При создании серверного приложения в диалоговом окне создания серверного приложения это свойство имеет значение URI идентификатора приложения.When you create the server app, in the Create Server Application window, this property is the App ID URI.

Администратор Azure может получить значение этого свойства на портале Azure.An Azure administrator can get the value for this property from the Azure portal. В Azure Active Directory найдите серверное приложение в разделе Регистрации приложений.In Azure Active Directory, find the server app under App registrations. Найдите тип приложения Веб-приложение или API.Look for application type Web app / API. Откройте приложение, выберите Параметры, а затем выберите Свойства.Open the app, select Settings, and then select Properties. Для этого свойства установки клиента AADRESOURCEURI используйте значение URI идентификатора приложения.Use the App ID URI value for this AADRESOURCEURI client installation property.

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

AADTENANTIDAADTENANTID

Указывает идентификатор клиента Azure AD.Specifies the Azure AD tenant identifier. Configuration Manager подключается к этому клиенту при настройке служб Azure для управления облачными клиентами.Configuration Manager links to this tenant when you configure Azure services for Cloud Management. Чтобы получить значение этого свойства, выполните следующие действия.To get the value for this property, use the following steps:

  • На устройстве Windows 10, присоединенном к тому же клиенту Azure AD, откройте командную строку.On a Windows 10 device that is joined to the same Azure AD tenant, open a command prompt.

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

  • В разделе "Состояние устройства" найдите значение TenantId.In the Device State section, find the TenantId value. Например, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49aFor example, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    Примечание

    Администратор Azure может также получить это значение на портале Azure.An Azure administrator can also obtain this value in the Azure portal. Дополнительные сведения см. в разделе Получение идентификатора клиента.For more information, see get tenant ID.

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

CCMADMINSCCMADMINS

Указывает одну или несколько учетных записей пользователя или групп Windows для предоставления доступа к параметрам и политикам клиента.Specifies one or more Windows user accounts or groups to be given access to client settings and policies. Это свойство полезно, если у вас нет прав локального администратора на клиентском компьютере.This property is useful when you don't have local administrative credentials on the client computer. Укажите список учетных записей, разделенных точкой с запятой (;).Specify a list of accounts that are separated by semicolons (;).

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

CCMALLOWSILENTREBOOTCCMALLOWSILENTREBOOT

При необходимости разрешите компьютеру автоматически перезагружаться после установки клиента.If necessary, allow the computer to silently restart after the client installation.

Важно!

При использовании этого свойства компьютер перезапускается без предупреждения.When you use this property, the computer restarts without warning. Такое поведение возникает, даже если пользователь вошел в Windows.This behavior occurs even if a user is signed in to Windows.

Пример: CCMSetup.exe CCMALLOWSILENTREBOOTExample: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINFCCMALWAYSINF

Установите значение 1, чтобы указать, что клиент всегда является интернет-клиентом и не подключается к интрасети.To specify that the client is always internet-based and never connects to the intranet, set this property value to 1. В типе подключения клиента будет отображено Всегда Интернет.The client's connection type displays Always Internet.

Используйте это свойство вместе со свойством CCMHOSTNAME, которое указывает полное доменное имя интернет-точки управления.Use this property with CCMHOSTNAME to specify the FQDN of the internet-based management point. Его также следует использовать вместе с параметром /UsePKICert программы CCMSetup и с кодом сайта (SMSSITECODE).Also use it with the CCMSetup parameter /UsePKICert and the site code (SMSSITECODE).

Дополнительные сведения об управлении клиентами через Интернет см. в разделе Рекомендации по взаимодействию с клиентами из Интернета или недоверенного леса.For more information about internet-based client management, see Considerations for client communications from the internet or an untrusted forest.

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

CCMCERTISSUERSCCMCERTISSUERS

Это свойство используется для указания списка издателей сертификатов.Use this property to specify the certificate issuers list. В этом списке содержатся сведения о сертификате для доверенных корневых центров сертификации (ЦС), которым доверяет сайт Configuration Manager.This list includes certificate information for the trusted root certification authorities (CA) that the Configuration Manager site trusts.

Значением является чувствительное к регистру соответствие для атрибутов в сертификате от корневого центра сертификации.This value is a case-sensitive match for subject attributes that are in the root CA certificate. Разделяйте атрибуты запятыми (,) или точкой с запятой (;).Separate attributes by a comma (,) or a semicolon (;). Укажите более одного корневого сертификата ЦС с помощью разделителя (|).Specify more than one root CA certificate by using a separator bar (|).

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

Совет

Используйте значение атрибута CertificateIssuers в файле mobileclient.tcf для сайта.Use the value of the CertificateIssuers attribute in the mobileclient.tcf file for the site. Этот файл находится во вложенной папке \bin\<platform> каталога установки Configuration Manager на сервере сайта.This file is in the \bin\<platform> subfolder of the Configuration Manager installation directory on the site server.

Дополнительные сведения о списке издателей сертификатов и его использовании клиентами в процессе выбора сертификата см. в статье Планирование выбора PKI-сертификата клиента.For more information about the certificate issuers list and how clients use it during the certificate selection process, see Planning for PKI client certificate selection.

CCMCERTSELCCMCERTSEL

Если клиент имеет более одного сертификата для обмена данными по протоколу HTTPS, это свойство задает критерии выбора допустимого сертификата проверки подлинности клиента.If the client has more than one certificate for HTTPS communication, this property specifies the criteria for it to select a valid client authentication certificate.

Используйте следующие ключевые слова для поиска имени субъекта или альтернативного имени субъекта сертификата:Use the following keywords to search the certificate Subject Name or Subject Alternative Name:

  • Тема. Поиск точного соответствияSubject: Find an exact match
  • SubjectStr. Поиск частичного соответствияSubjectStr: Find a partial match

Примеры:Examples:

  • CCMCERTSEL="Subject:computer1.contoso.com": выполняет поиск сертификата с точным совпадением с именем компьютера computer1.contoso.com в имени субъекта или альтернативном имени субъекта.CCMCERTSEL="Subject:computer1.contoso.com": Search for a certificate with an exact match to the computer name computer1.contoso.com in the Subject Name or the Subject Alternative Name.

  • CCMCERTSEL="SubjectStr:contoso.com": выполняет поиск сертификата, содержащего contoso.com в имени субъекта или альтернативном имени субъекта.CCMCERTSEL="SubjectStr:contoso.com": Search for a certificate that contains contoso.com in the Subject Name or the Subject Alternative Name.

Используйте ключевое слово SubjectAttr для поиска идентификатора объекта (OID) или атрибутов различающегося имени в имени субъекта или альтернативном имени субъекта.Use the SubjectAttr keyword to search for the Object Identifier (OID) or distinguished name attributes in the Subject Name or Subject Alternative Name.

Примеры:Examples:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": выполняет поиск атрибута подразделения, выраженного как идентификатор объекта, с именем Computers.CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": Search for the organizational unit attribute expressed as an object identifier and named Computers.

  • CCMCERTSEL="SubjectAttr:OU = Computers": выполняет поиск атрибута подразделения, выраженного как различающееся имя, с именем Computers.CCMCERTSEL="SubjectAttr:OU = Computers": Search for the organizational unit attribute expressed as a distinguished name, and named Computers.

Важно!

Если используется поле "Имя субъекта", ключевое слово Subject учитывает регистр, а ключевое слово SubjectStr:  — не учитывает.If you use the Subject Name, the Subject keyword is case-sensitive, and the SubjectStr keyword is case-insensitive.

Если используется поле "Альтернативное имя субъекта", ключевые слова Subject и SubjectStr не учитывают регистр.If you use the Subject Alternative Name, both the Subject and the SubjectStr keywords are case-insensitive.

Полный список атрибутов, которые можно использовать для выбора сертификата, перечислен в разделе Поддерживаемые значения атрибутов для критериев выбора сертификата инфраструктуры открытого ключа.For the complete list of attributes that you can use for certificate selection, see Supported attribute values for PKI certificate selection criteria.

Если в результате поиска обнаружено несколько соответствующих сертификатов и для свойства CCMFIRSTCERT было указано значение 1, установщик клиента выбирает сертификат с наибольшим сроком действия.If more than one certificate matches the search, and you set CCMFIRSTCERT to 1, then the client installer selects the certificate with the longest validity period.

CCMCERTSTORECCMCERTSTORE

Если установщик клиента не может определить допустимый сертификат в личном хранилище сертификатов для компьютера, используйте это свойство, чтобы указать альтернативное имя хранилища сертификатов.If the client installer can't locate a valid certificate in the default Personal certificate store for the computer, use this property to specify an alternate certificate store name.

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

CCMDEBUGLOGGINGCCMDEBUGLOGGING

Это свойство включает ведение журнала отладки при установке клиента.This property enables debug logging when the client installs. Это свойство заставляет клиента заносить в журнал сведения низкого уровня для устранения неполадок.This property causes the client to log low-level information for troubleshooting. Избегайте использования этого свойства на рабочих сайтах.Avoid using this property in production sites. Оно может привести к избыточному ведению журналов, затрудняющему поиск нужных сведений в файлах журнала.Excessive logging can occur, which might make it difficult to find relevant information in the log files. Также включите CCMENABLELOGGING.Also enable CCMENABLELOGGING.

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

  • 0: отключение ведения журнала отладки (по умолчанию)0: Turn off debug logging (default)
  • 1: включение ведения журнала отладки.1: Turn on debug logging

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

Дополнительные сведения см. в разделе О файлах журналов.For more information, see About log files.

CCMENABLELOGGINGCCMENABLELOGGING

По умолчанию Configuration Manager включает ведение журнала.Configuration Manager enables logging by default.

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

  • TRUE: включить ведение журнала (по умолчанию)TRUE: Turn on logging (default)
  • FALSE: отключить ведение журналаFALSE: Turn off logging

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

Дополнительные сведения см. в разделе О файлах журналов.For more information, see About log files.

CCMEVALINTERVALCCMEVALINTERVAL

Частота запуска средства оценки работоспособности клиента (ccmeval.exe) в минутах.The frequency in minutes at which the client health evaluation tool (ccmeval.exe) runs. Укажите целочисленное значение в диапазоне от 1 до 1440.Specify an integer value from 1 to 1440. По умолчанию ccmeval запускается один раз в день (1440 минут).By default, ccmeval runs once a day (1440 minutes).

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

Дополнительные сведения об оценке работоспособности клиента см. в разделе Мониторинг клиентов.For more information on client health evaluation, see Monitor clients.

CCMEVALHOURCCMEVALHOUR

Час в течение дня для запуска средства оценки работоспособности клиента (ccmeval.exe).The hour during the day when the client health evaluation tool (ccmeval.exe) runs. Укажите целочисленное значение от 0 (полночь) до 23 (23:00).Specify an integer value from 0 (midnight) to 23 (11:00 PM). По умолчанию ccmeval запускается в полночь.By default, ccmeval runs at midnight.

Дополнительные сведения об оценке работоспособности клиента см. в разделе Мониторинг клиентов.For more information on client health evaluation, see Monitor clients.

CCMFIRSTCERTCCMFIRSTCERT

Если свойству задано значение 1, клиент выбирает PKI-сертификат с наибольшим сроком действия.If you set this property to 1, the client selects the PKI certificate with the longest validity period.

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

CCMHOSTNAMECCMHOSTNAME

Указывает полное доменное имя интернет-точки управления, если клиент управляется по Интернету.If the client is managed over the internet, this property specifies the FQDN of the internet-based management point.

Не задавайте этот параметр со свойством установки SMSSITECODE=AUTO.Don't specify this option with the installation property of SMSSITECODE=AUTO. Интернет-клиенты должны быть напрямую назначены их интернет-сайту.Directly assign internet-based clients to an internet-based site.

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

Это свойство может указывать адрес шлюза управления облачными клиентами (CMG).This property can specify the address of a cloud management gateway (CMG). Чтобы получить значение этого свойства, выполните следующие действия.To get the value for this property, use the following steps:

  • Создайте CMG.Create a CMG. Дополнительные сведения см. в разделе Настройка CMG.For more information, see Set up a CMG.

  • На активном клиенте откройте командную строку Windows PowerShell с правами администратора.On an active client, open a Windows PowerShell command prompt as an administrator.

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

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

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

Важно!

При указании адреса CMG для свойства CCMHOSTNAME не добавляйте префикс, например https://.When you specify the address of a CMG for the CCMHOSTNAME property, don't append a prefix such as https://. Используйте этот префикс с URL-адресом /mp CMG.Only use this prefix with the /mp URL of a CMG.

CCMHTTPPORTCCMHTTPPORT

Указывает порт, используемый клиентом для обмена данными с серверами системы сайта по протоколу HTTP.Specifies the port for the client to use when it communicates over HTTP to site system servers. Значение по умолчанию — 80.By default, this value is 80.

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

CCMHTTPSPORTCCMHTTPSPORT

Указывает порт, используемый клиентом для обмена данными с серверами системы сайта по протоколу HTTPS.Specifies the port for the client to use when it communicates over HTTPS to site system servers. Значение по умолчанию — 443.By default, this value is 443.

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

CCMINSTALLDIRCCMINSTALLDIR

Используйте это свойство, чтобы задать папку для установки файлов клиента Configuration Manager.Use this property to set the folder to install the Configuration Manager client files. По умолчанию используется %WinDir%\CCM.By default, it uses %WinDir%\CCM.

Совет

Независимо от того, где устанавливаются клиентские файлы, файл ccmcore.dll всегда устанавливается в папку %WinDir%\System32.Regardless of where you install the client files, it always installs the ccmcore.dll file in the %WinDir%\System32 folder. В 64-разрядной ОС копия ccmcore.dll устанавливается в папку %WinDir%\SysWOW64.On a 64-bit OS, it installs a copy of ccmcore.dll in the %WinDir%\SysWOW64 folder. Этот файл поддерживает 32-разрядные приложения, использующие 32-разрядную версию клиентских API из пакета SDK для Configuration Manager.This file supports 32-bit applications that use the 32-bit version of the client APIs from the Configuration Manager SDK.

Пример: CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"Example: CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"

CCMLOGLEVELCCMLOGLEVEL

Используйте это свойство, чтобы указать уровень детализации для записи в файлы журналов Configuration Manager.Use this property to specify the level of detail to write to Configuration Manager log files.

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

  • 0: Подробные сведения0: Verbose
  • 1: По умолчанию1: Default
  • 2: предупреждения и ошибки2: Warnings and errors
  • 3: только ошибки3: Errors only

Пример: CCMSetup.exe CCMLOGLEVEL=0Example: CCMSetup.exe CCMLOGLEVEL=0

Дополнительные сведения см. в разделе О файлах журналов.For more information, see About log files.

CCMLOGMAXHISTORYCCMLOGMAXHISTORY

Когда файл журнала Configuration Manager достигает максимального размера, клиент переименовывает его в резервную копию и создает новый файл журнала.When a Configuration Manager log file reaches the maximum size, the client renames it as a backup and creates a new log file. Это свойство указывает, сколько предыдущих версий файла требуется сохранять.This property specifies how many previous versions of the log file to keep. Значение по умолчанию — 1.The default value is 1. Если задать значение 0, клиент не сохранит историю файлов журнала.If you set the value to 0, the client doesn't keep any log file history.

Пример: CCMSetup.exe CCMLOGMAXHISTORY=5Example: CCMSetup.exe CCMLOGMAXHISTORY=5

Дополнительные сведения см. в разделе О файлах журналов.For more information, see About log files.

CCMLOGMAXSIZECCMLOGMAXSIZE

Это свойство задает максимальный размер файла журнала в байтах.This property specifies the maximum log file size in bytes. Если размер журнала увеличивается до заданного значения, клиент переименовывает его в архивный файл и создает новый файл.When a log grows to the specified size, the client renames it as a history file, and creates a new one. Размер по умолчанию составляет 250 000 байт, а минимальный размер — 10 000 байт.The default size is 250,000 bytes, and the minimum size is 10,000 bytes.

Пример: CCMSetup.exe CCMLOGMAXSIZE=300000 (300 000 байт)Example: CCMSetup.exe CCMLOGMAXSIZE=300000 (300,000 bytes)

DISABLESITEOPTDISABLESITEOPT

Присвойте этому свойству значение TRUE, чтобы запретить администраторам изменять назначенный сайт на панели управления Configuration Manager.Set this property to TRUE to block administrators from changing the assigned site in the Configuration Manager control panel.

Пример: CCMSetup.exe DISABLESITEOPT=TRUEExample: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPTDISABLECACHEOPT

Если задано значение TRUE, это свойство запрещает администраторам изменять параметры папки кэша клиента на панели управления Configuration Manager.If set to TRUE, this property disables the ability of administrative users from changing the client cache folder settings in the Configuration Manager control panel.

Пример: CCMSetup.exe DISABLECACHEOPT=TRUEExample: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIXDNSSUFFIX

Укажите DNS-домен для использования клиентами при поиске точек управления, опубликованных в DNS.Specify a DNS domain for clients to locate management points that you publish in DNS. После нахождения клиентом точки управления он информирует клиент о других точках управления в иерархии.When the client locates a management point, it tells the client about other management points in the hierarchy. Такое поведение означает, что точка управления, найденная клиентом из DNS, может быть любой точкой управления в иерархии.This behavior means that the management point that the client finds from DNS can be any one in the hierarchy.

Примечание

Если клиент находится в том же домене, что и опубликованная точка управления, указывать это свойство не требуется.You don't have to specify this property if the client is in the same domain as a published management point. В этом сценарии автоматически используется домен клиента для поиска точек управления в DNS.In that case, the client's domain is automatically used to search DNS for management points.

Дополнительные сведения о публикации DNS как методе обнаружения служб для клиентов Configuration Manager см. в разделе Обнаружение службы и определение клиентами назначенной им точки управления.For more information about DNS publishing as a service location method for Configuration Manager clients, see Service location and how clients determine their assigned management point.

Примечание

По умолчанию в Configuration Manager отключена публикация DNS.By default, Configuration Manager doesn't enable DNS publishing.

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

FSPFSP

Укажите резервную точку состояния, которая будет получать и обрабатывать сообщения о состоянии, отправленные клиентами Configuration Manager.Specify the fallback status point that receives and processes state messages sent by Configuration Manager clients.

Дополнительные сведения см. в разделе Определение необходимости в резервной точке состояния.For more information, see Determine if you need a fallback status point.

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

IGNOREAPPVVERSIONCHECKIGNOREAPPVVERSIONCHECK

Если задать для этого свойства значение TRUE, то установщик клиента не будет проверять минимальную необходимую версию Microsoft Application Virtualization (App-V).If you set this property to TRUE, the client installer doesn't check the minimum required version of Microsoft Application Virtualization (App-V).

Важно!

Если установить клиент Configuration Manager без установки App-V, развертывание виртуальных приложений будет невозможным.If you install the Configuration Manager client without installing App-V, you can't deploy virtual applications.

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

NOTIFYONLYNOTIFYONLY

При включении этого свойства клиент сообщает о состоянии, но не устраняет обнаруженные им проблемы.When you enable this property, the client reports status, but doesn't remediate problems that it finds.

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

Дополнительные сведения см. в статье Настройка состояния клиента.For more information, see How to configure client status.

PROVISIONTSPROVISIONTS

Начиная с версии 2002, это свойство используется для запуска последовательности задач в клиенте после того, как она успешно зарегистрирована на сайте.Starting in version 2002, use this property to start a task sequence on a client after it successfully registers with the site.

Примечание

Если последовательность задач устанавливает обновления программного обеспечения или приложения, клиентам необходим действительный сертификат проверки подлинности.If the task sequence installs software updates or applications, clients need a valid client authentication certificate. Одной только проверки подлинности на основе токена будет недостаточно.Token authentication alone doesn't work. Дополнительные сведения см. в разделе Заметки о выпуске — развертывание ОС.For more information, see Release notes - OS deployment.

Например, вы подготавливаете новое устройство Windows 10 с помощью Windows Autopilot, автоматически регистрируете его в Microsoft Intune, а затем устанавливаете клиент Configuration Manager для совместного управления.For example, you provision a new Windows 10 device with Windows Autopilot, auto-enroll it to Microsoft Intune, and then install the Configuration Manager client for co-management. Если указать этот новый параметр, то вновь подготовленный клиент после этого выполняет последовательность задач.If you specify this new option, the newly provisioned client then runs a task sequence. Этот процесс обеспечивает дополнительную гибкость при установке приложений и обновлений программного обеспечения, а также настройке параметров.This process gives you additional flexibility to install applications and software updates, or configure settings.

Используйте следующую процедуру.Use the following process:

  1. Создайте последовательность задач развертывания не для ОС, чтобы устанавливать приложения и обновления программного обеспечения, а также настраивать параметры.Create a non-OS deployment task sequence to install apps, install software updates, and configure settings.

  2. Разверните эту последовательность задач для новой встроенной коллекции — Все устройства подготовки.Deploy this task sequence to the new built-in collection, All Provisioning Devices. Запишите идентификатор развертывания последовательности задач, например PRI20001.Note the task sequence deployment ID, for example PRI20001.

    Совет

    Цель развертывания может быть либо доступной, либо обязательной.The deployment's purpose can be either available or required. Поскольку идентификатор развертывания указывается как значение свойства, цель не имеет значения.Since you specify the deployment ID as the property value, the purpose doesn't matter.

  3. Установите клиент Configuration Manager на устройстве и включите следующее свойство: PROVISIONTS=PRI20001.Install the Configuration Manager client on a device, and include the following property: PROVISIONTS=PRI20001. Задайте значение этого свойства в качестве идентификатора развертывания последовательности задач.Set the value of this property as the task sequence deployment ID.

После установки и правильной регистрации клиента на сайте запускается указанная последовательность задач.After the client installs and properly registers with the site, it starts the referenced task sequence. Если регистрация клиента завершается неудачей, последовательность задач не запускается.If client registration fails, the task sequence won't start.

RESETKEYINFORMATIONRESETKEYINFORMATION

Если у клиента имеется неправильный ключ доверенного корня Configuration Manager и ему не удается установить связь с доверенной точкой управления для получения нового ключа доверенного корня,If a client has the wrong Configuration Manager trusted root key, it can't contact a trusted management point to receive the new trusted root key. используйте это свойство, чтобы вручную удалить старый ключ доверенного корня.Use this property to remove the old trusted root key. Такая ситуация может возникнуть при перемещении клиента из одной иерархии сайта в другую.This situation may occur when you move a client from one site hierarchy to another. Это свойство применимо к клиентам, использующим соединения по протоколам HTTP и HTTPS.This property applies to clients that use HTTP and HTTPS client communication. Дополнительные сведения см. в разделе Планирование доверенного корневого ключа.For more information, see Planning for the trusted root key.

Пример: CCMSetup.exe RESETKEYINFORMATION=TRUEExample: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGNSITEREASSIGN

Обеспечивает автоматическое переназначение сайта при обновлении клиентов при использовании с параметром SMSSITECODE=AUTO.Enables automatic site reassignment for client upgrades when used with SMSSITECODE=AUTO.

Пример: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUEExample: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIRSMSCACHEDIR

Указывает расположение папки кэша клиента на клиентском компьютере.Specifies the location of the client cache folder on the client computer. Расположение кэша по умолчанию — %WinDir%\ccmcache.By default, the cache location is %WinDir%\ccmcache.

Пример: CCMSetup.exe SMSCACHEDIR="C:\Temp"Example: CCMSetup.exe SMSCACHEDIR="C:\Temp"

Используйте это свойство со свойством SMSCACHEFLAGS, чтобы управлять расположением папки кэша клиента.Use this property with the SMSCACHEFLAGS property to control the client cache folder location. Например, чтобы установить папку кэша клиента на самом большом доступном диске клиента, выполните следующие действия. CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVEFor example, to install the client cache folder on the largest available client disk drive: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGSSMSCACHEFLAGS

Это свойство используется для указания дополнительных сведений об установке для папки кэша клиента.Use this property to specify further installation details for the client cache folder. Свойства SMSCACHEFLAGS можно использовать отдельно или в сочетании, разделяя точкой с запятой (;).You can use SMSCACHEFLAGS properties individually or in combination separated by semicolons (;).

Если не включить это свойство, произойдет следующее.If you don't include this property:

  • Клиент устанавливает папку кэша в соответствии со свойством SMSCACHEDIRThe client installs the cache folder according to the SMSCACHEDIR property
  • Папка не сжимаетсяThe folder isn't compressed
  • Клиент использует свойство SMSCACHESIZE в качестве ограничения размера кэша (в МБ).The client uses the SMSCACHESIZE property as the size limit in MB of the cache

При обновлении существующего клиента установщик клиента игнорирует это свойство.When you upgrade an existing client, the client installer ignores this property.

Значения для свойства SMSCACHEFLAGSValues for the SMSCACHEFLAGS property

  • PERCENTDISKSPACE: указывает размер кэша в процентах от общего места на диске.PERCENTDISKSPACE: Set the cache size as a percentage of the total disk space. Если указано это свойство, также задайте для параметра SMSCACHESIZE значение в процентах.If you specify this property, also set SMSCACHESIZE to a percentage value.

  • PERCENTFREEDISKSPACE: указывает размер кэша в процентах от свободного места на диске.PERCENTFREEDISKSPACE: Set the cache size as a percentage of the free disk space. Если указано это свойство, также задайте для параметра SMSCACHESIZE значение в процентах.If you specify this property, also set SMSCACHESIZE as a percentage value. Например, на диске свободно 10 МБ, следовательно, указать нужно SMSCACHESIZE=50.For example, the disk has 10 MB free, and you specify SMSCACHESIZE=50. Установщик клиента устанавливает размер кэша равным 5 МБ.The client installer sets the cache size to 5 MB. Это свойство нельзя использовать вместе со свойством PERCENTDISKSPACE.You can't use this property with the PERCENTDISKSPACE property.

  • MAXDRIVE: установка кэша на самый большой доступный диск.MAXDRIVE: Install the cache on the largest available disk. Если указать путь со свойством SMSCACHEDIR, установщик клиента пропускает это значение.If you specify a path with the SMSCACHEDIR property, the client installer ignores this value.

  • MAXDRIVESPACE: установка кэша на диске с наибольшим объемом свободного пространства.MAXDRIVESPACE: Install the cache on the disk drive with the most free space. Если указать путь со свойством SMSCACHEDIR, установщик клиента пропускает это значение.If you specify a path with the SMSCACHEDIR property, the client installer ignores this value.

  • NTFSONLY: установка кэша только на диск с файловой системой NTFS.NTFSONLY: Only install the cache on an NTFS-formatted disk drive. Если указать путь со свойством SMSCACHEDIR, установщик клиента пропускает это значение.If you specify a path with the SMSCACHEDIR property, the client installer ignores this value.

  • COMPRESS: хранение кэша в сжатой форме.COMPRESS: Store the cache in a compressed form.

  • FAILIFNOSPACE: если недостаточно места для установки кэша, удалите клиент Configuration Manager.FAILIFNOSPACE: If there's insufficient space to install the cache, remove the Configuration Manager client.

Пример: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESSExample: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZESMSCACHESIZE

Важно!

Доступны параметры клиента для указания размера папки кэша клиента.Client settings are available for specifying the client cache folder size. Добавление этих параметров клиента заменяет использование параметра SMSCACHESIZE как свойства client.msi для указания размера кэша клиента.The addition of those client settings effectively replaces using SMSCACHESIZE as a client.msi property to specify the size of the client cache. Дополнительные сведения см. в разделе Параметры клиента для размера кэша.For more information, see the client settings for cache size.

При обновлении существующего клиента установщик клиента игнорирует эту настройку.When you upgrade an existing client, the client installer ignores this setting. Клиент также игнорирует размер кэша при загрузке обновлений программного обеспечения.The client also ignores the cache size when it downloads software updates.

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

Примечание

При переустановке клиента нельзя использовать свойства SMSCACHESIZE или SMSCACHEFLAGS, чтобы уменьшить размер кэша.If you reinstall a client, you can't use SMSCACHESIZE or SMSCACHEFLAGS to set the cache size to be smaller than it was previously. Предыдущий размер — это минимальное значение.The previous size is the minimum value.

SMSCONFIGSOURCESMSCONFIGSOURCE

Это свойство используется для указания расположения и порядка, в котором установщик клиента проверяет параметры конфигурации.Use this property to specify the location and order that the client installer checks for configuration settings. Оно является строкой, содержащей один или более символов, каждый из которых определяет конкретный источник конфигурации.It's a string of one or more characters, each defining a specific configuration source:

  • R: проверяет на параметры конфигурации в реестре.R: Check for configuration settings in the registry.

    Дополнительные сведения см. в статье Подготовка свойств установки клиента.For more information, see Provision client installation properties.

  • P: проверяет на параметры конфигурации в свойствах установки, заданных в командной строке.P: Check for configuration settings in the installation properties from the command line.

  • M: проверяет наличие существующих параметров при обновлении старого клиента.M: Check for existing settings when you upgrade an older client.

  • U: обновляет установленный клиент до более новой версии (и использует назначенный код сайта).U: Upgrade the installed client to a newer version and use the assigned site code.

По умолчанию установщик клиента использует PU.By default, the client installer uses PU. Сначала он проверяет свойства установки (P), а затем существующие параметры (U).It first checks the installation properties (P) and then the existing settings (U).

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

SMSDIRECTORYLOOKUPSMSDIRECTORYLOOKUP

Указывает, может ли клиент использовать службу WINS для обнаружения точки управления, принимающей подключения по протоколу HTTP.Specifies whether the client can use Windows Internet Name Service (WINS) to find a management point that accepts HTTP connections. Клиенты используют этот метод, когда они не могут обнаружить точку управления в доменных службах Active Directory или в DNS.Clients use this method when they can't find a management point in Active Directory Domain Services or in DNS.

Это свойство не влияет на использование клиентом WINS для разрешения имен.This property doesn't affect whether the client uses WINS for name resolution.

Для этого свойства можно настроить два различных режима.You can configure two different modes for this property:

  • NOWINS: значение является наиболее безопасным параметром для этого свойства.NOWINS: This value is the most secure setting for this property. Этот параметр не дает клиентам найти точку управления в WINS.It prevents clients from finding a management point in WINS. При использовании этого параметра у клиентов должен быть альтернативный метод нахождения точки управления в интрасети.When you use this setting, clients must have an alternative method to locate a management point on the intranet. Например в доменных службах Active Directory или посредством публикации DNS.For example, Active Directory Domain Services or DNS publishing.

  • WINSSECURE (по умолчанию): В этом режиме клиент, использующий соединения по протоколу HTTP, может обнаруживать точку управления с использованием WINS.WINSSECURE (default): In this mode, a client that uses HTTP communication can use WINS to find a management point. Однако у клиента должна быть копия доверенного корневого ключа, чтобы он мог успешно подключиться к точке управления.However, the client must have a copy of the trusted root key before it can successfully connect to the management point. Дополнительные сведения см. в разделе Планирование доверенного корневого ключа.For more information, see Planning for the trusted root key.

Пример: CCMSetup.exe SMSDIRECTORYLOOKUP=NOWINSExample: CCMSetup.exe SMSDIRECTORYLOOKUP=NOWINS

SMSMPSMSMP

Задает начальную точку управления для использования клиентом Configuration Manager.Specifies an initial management point for the Configuration Manager client to use.

Важно!

Если точка управления принимает подключения клиентов только по протоколу HTTPS, добавьте к имени точки управления https:// в качестве префикса.If the management point only accepts client connections over HTTPS, prefix the management point name with https://.

Примеры:Examples:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSPUBLICROOTKEYSMSPUBLICROOTKEY

Если клиенту не удается получить доверенный корневой ключ Configuration Manager доменных служб Active Directory, используйте это свойство, чтобы указать ключ.If the client can't get the Configuration Manager trusted root key from Active Directory Domain Services, use this property to specify the key. Это свойство применимо к клиентам, использующим соединения по протоколам HTTP и HTTPS.This property applies to clients that use HTTP and HTTPS communication. Дополнительные сведения см. в разделе Планирование доверенного корневого ключа.For more information, see Planning for the trusted root key.

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

Совет

Получите значение доверенного корневого ключа сайта из файла mobileclient.tcf на сервере сайта.Get the value for the site's trusted root key from the mobileclient.tcf file on the site server. Дополнительные сведения см. в разделе Предоставление корневого ключа доверия клиенту в виде файла.For more information, see Pre-provision a client with the trusted root key by using a file.

SMSROOTKEYPATHSMSROOTKEYPATH

Это свойство используется для переустановки доверенного корневого ключа Configuration Manager.Use this property to reinstall the Configuration Manager trusted root key. Оно указывает полный путь и имя файла, в котором содержится доверенный корневой ключ.It specifies the full path and name of a file that contains the trusted root key. Это свойство применимо к клиентам, использующим соединения по протоколам HTTP и HTTPS.This property applies to clients that use HTTP and HTTPS client communication. Дополнительные сведения см. в разделе Планирование доверенного корневого ключа.For more information, see Planning for the trusted root key.

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

SMSSIGNCERTSMSSIGNCERT

Указывает полный путь и имя файла экспортируемого самозаверяющего сертификата на сервере сайта.Specifies the full path and name of the exported self-signed certificate on the site server. Сервер сайта хранит этот сертификат в хранилище сертификатов SMS.The site server stores this certificate in the SMS certificate store. Он имеет имя субъекта Сервер сайта и понятное имя — Сертификат подписи сервера сайта.It has the Subject name Site Server and the friendly name Site Server Signing Certificate.

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

SMSSITECODESMSSITECODE

Это свойство задает сайт Configuration Manager, которому назначается клиент.This property specifies a Configuration Manager site to which you assign the client. Этим значением может быть либо трехсимвольный код сайта, либо слово AUTO.This value can either be a three-character site code or the word AUTO. Если указывается значение AUTO или это свойство не указывается, клиент пытается определить назначение сайта в доменных службах Active Directory или на указанной точке управления.If you specify AUTO, or don't specify this property, the client attempts to determine its site assignment from Active Directory Domain Services or from a specified management point. Чтобы задать значение AUTO для обновления клиентов, необходимо также задать SITEREASSIGN=TRUE.To enable AUTO for client upgrades, also set SITEREASSIGN=TRUE.

Примечание

Если также указать интернет-точку управления с помощью свойства CCMHOSTNAME, не используйте AUTO со свойством SMSSITECODE.If you also specify an internet-based management point with the CCMHOSTNAME property, don't use AUTO with SMSSITECODE. Напрямую назначьте клиент своему сайту, указав код сайта.Directly assign the client to its site by specifying the site code.

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

Значения атрибутов для критериев выбора сертификата.Attribute values for certificate selection criteria

Configuration Manager поддерживает следующие значения атрибутов для критериев выбора PKI-сертификата:Configuration Manager supports the following attribute values for the PKI certificate selection criteria:

Атрибут OIDOID attribute Атрибут различающегося имениDistinguished Name attribute Определение атрибутаAttribute definition
0.9.2342.19200300.100.1.250.9.2342.19200300.100.1.25 DCDC Компонент доменаDomain component
1.2.840.113549.1.9.11.2.840.113549.1.9.1 E или E-mailE or E-mail Адрес электронной почтыEmail address
2.5.4.32.5.4.3 CNCN Общее имяCommon name
2.5.4.42.5.4.4 SNSN Имя субъектаSubject name
2.5.4.52.5.4.5 SERIALNUMBERSERIALNUMBER Серийный номерSerial number
2.5.4.62.5.4.6 ВC Код страныCountry code
2.5.4.72.5.4.7 LL МестонахождениеLocality
2.5.4.82.5.4.8 S или STS or ST Название штата или провинцииState or province name
2.5.4.92.5.4.9 STREETSTREET Адрес по улицеStreet address
2.5.4.102.5.4.10 OO Название организацииOrganization name
2.5.4.112.5.4.11 OUOU ПодразделениеOrganizational unit
2.5.4.122.5.4.12 T или TitleT or Title НазваниеTitle
2.5.4.422.5.4.42 G или GN или GivenNameG or GN or GivenName ИмяGiven name
2.5.4.432.5.4.43 I или InitialsI or Initials ИнициалыInitials
2.5.29.172.5.29.17 (без значения)(no value) Альтернативное имя субъектаSubject Alternative Name