Поделиться через


Set-CMClientPushInstallation

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

Синтаксис

Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   -InputObject <IResultObject>
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   [-RemoveAccount <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   -InputObject <IResultObject>
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   [-RemoveAccount <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   -Name <String>
   [-RemoveAccount <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   [-RemoveAccount <String[]>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Вы также можете запустить принудительную установку клиента, запустив мастер принудительной установки клиента для определенной коллекции или ресурса в коллекции.

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

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Изменение параметров принудительной установки клиента

Эта команда создает следующие конфигурации:

  • Автоматическое использование принудительной отправки клиента для обнаруженных компьютеров.
  • Отправка клиента на серверы системы сайта
  • Сайт использует учетную запись contoso\svc_smspush для подключения к компьютеру для установки клиентского программного обеспечения.

Параметр InstallationProperty задает для свойства SMSSITECODE для пакета установщика Windows значение CM1. Этот параметр назначает клиент сайту с кодом сайта CM1.

Set-CMClientPushInstallation -SiteCode "CM1" -EnableAutomaticClientPushInstallation $True -EnableSystemTypeConfiguationManager $True -ChosenAccount "contoso\svc_smspush" -InstallationProperty "SMSSITECODE=CM1"

Параметры

-AddAccount

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

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

Тип:String[]
Aliases:AddAccounts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllownNTLMFallback

Если этот параметр $true, если сайту не удается проверить подлинность клиента с помощью Kerberos, он повторяет подключение с помощью NTLM. Рекомендуемая конфигурация для повышения безопасности заключается в том, чтобы задать для этого параметра значение $false, что требует kerberos без резервного использования NTLM.

Примечание.

При использовании принудительной отправки клиента для установки клиента Configuration Manager сервер сайта создает удаленное подключение к клиенту. Сайт может требовать взаимную проверку подлинности Kerberos, не разрешая возврат к NTLM перед установкой подключения. Такое поведение помогает защитить обмен данными между сервером и клиентом.

В зависимости от политик безопасности ваша среда может уже предпочесть или требовать kerberos вместо более старой проверки подлинности NTLM. Дополнительные сведения о безопасности этих протоколов проверки подлинности см. в статье Параметр политики безопасности Windows для ограничения NTLM.

Чтобы использовать эту функцию, клиенты должны находиться в доверенном лесу Active Directory. Kerberos в Windows использует Active Directory для взаимной проверки подлинности.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ChosenAccount

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

Тип:String[]
Aliases:ChosenAccounts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ClearAccount

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

Тип:SwitchParameter
Aliases:ClearAccounts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableAutomaticClientPushInstallation

Задайте для этого параметра значение $true , чтобы установить клиент Configuration Manager на недавно обнаруженных ресурсах компьютера. Это также позволяет установить существующие ресурсы компьютера, на которых не установлен клиент.

Если для этого параметра задано значение $false, вы по-прежнему можете использовать действие Установить клиента на коллекции или устройстве.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableSystemTypeConfigurationManager

Задайте для этого параметра значение $true , чтобы установить клиент Configuration Manager на серверах системы сайта.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableSystemTypeServer

Задайте для этого параметра значение $true , чтобы установить клиент Configuration Manager на серверах.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableSystemTypeWorkstation

Задайте для этого параметра значение $true , чтобы установить клиент Configuration Manager на рабочих станциях.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Укажите объект принудительной установки клиента. Чтобы получить этот объект, используйте командлет Get-CMClientPushInstallation .

Тип:IResultObject
Aliases:ClientPushComponent
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-InstallationProperty

Укажите все свойства установки, которые будут использоваться при установке клиента Configuration Manager.

Например:

/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSSITECODE="XYZ" SMSMP=mp01.contoso.com

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InstallClientToDomainController

Задайте этот параметр, чтобы указать, следует ли устанавливать клиент Configuration Manager на контроллерах домена:

  • $true: всегда устанавливайте клиент на контроллерах домена.
  • $false: никогда не устанавливайте клиент на контроллеры домена, если не указано в мастере принудительной установки клиента.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

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

Тип:String
Aliases:SiteName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveAccount

Укажите массив строк учетных записей принудительной установки клиента для удаления. Чтобы удалить все учетные записи, используйте параметр ClearAccount .

Тип:String[]
Aliases:RemoveAccounts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SiteCode

Укажите код сайта из трех символов. Например, XYZ.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject