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

Start-CMClientSettingDeployment

  • Ссылка
Модуль:
ConfigurationManager

(Не рекомендуется) Развертывает параметры клиента на устройствах в коллекции.

Синтаксис

Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-CMClientSettingDeployment развертывает параметры клиента на устройствах в коллекции Configuration Manager. Укажите объект параметра клиента, используя его имя или идентификатор, или можно использовать командлет Get-CMClientSetting , чтобы получить объект параметра клиента. Укажите коллекцию, к которой будут применены параметры, используя ее имя или идентификатор, или можно использовать командлет Get-CMDeviceCollection , чтобы получить коллекцию устройств.

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

Важно!

Начиная с версии 2107 этот командлет не рекомендуется использовать и может быть удален в будущем выпуске. Вместо этого используйте командлет New-CMClientSettingDeployment .

Примеры

Пример 1. Развертывание объекта параметра клиента с использованием его идентификатора в именованной коллекции

PS XYZ:\> Start-CMClientSettingDeployment -ClientSettingId "CSI1023" -CollectionName "General Computer Collection"

Эта команда запускает развертывание объекта параметра клиента, имеющего идентификатор CSI1023 для коллекции с именем General Computer Collection.

Пример 2. Развертывание объекта параметра клиента с помощью переменной

PS XYZ:\> $CSID = Get-CMClientSetting -Id "CSI1023"
PS XYZ:\> Start-CMClientSettingDeployment -ClientSetting $CSID -CollectionName "General Computer Collection"

Первая команда получает объект параметра клиента, имеющий идентификатор CSI1023, и сохраняет его в переменной $CSID.

Вторая команда запускает развертывание объекта параметра клиента в переменной $CSID в коллекцию с именем General Computer Collection.

Параметры

-ClientSetting

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

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

-ClientSettingId

Указывает идентификатор объекта параметров клиента.

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

-ClientSettingName

Указывает имя объекта параметра клиента.

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

-Collection

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

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

-CollectionId

Указывает идентификатор коллекции Configuration Manager. Configuration Manager применяет параметры клиента к членам этой коллекции.

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

-CollectionName

Указывает имя коллекции Configuration Manager. Configuration Manager применяет параметры клиента к членам этой коллекции.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

-ForceWildcardHandling

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

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object