Start-CMClientSettingDeployment

(Preterido) Implementa definições de cliente em dispositivos numa coleção.

Sintaxe

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

Description

O cmdlet Start-CMClientSettingDeployment implementa definições de cliente em dispositivos numa coleção do Configuration Manager. Especifique o objeto de definição de cliente com o respetivo nome ou ID ou pode utilizar o cmdlet Get-CMClientSetting para obter um objeto de definição de cliente. Especifique a coleção a que pretende aplicar as definições com o respetivo nome ou ID ou pode utilizar o cmdlet Get-CMDeviceCollection para obter uma coleção de dispositivos.

Para obter mais informações sobre as definições de cliente, veja About Client Settings in Configuration Manager (Acerca das Definições de Cliente no Configuration Manager).

Importante

A partir da versão 2107, este cmdlet foi preterido e poderá ser removido numa versão futura. Em vez disso, utilize o cmdlet New-CMClientSettingDeployment .

Exemplos

Exemplo 1: Implementar um objeto de definição de cliente com o respetivo ID numa coleção com nome

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

Este comando inicia a implementação do objeto de definição de cliente que tem o ID CSI1023 para a coleção denominada Coleção Geral de Computadores.

Exemplo 2: Implementar um objeto de definição de cliente com uma variável

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

O primeiro comando obtém um objeto de definição de cliente que tem o ID CSI1023 e guarda-o na variável $CSID.

O segundo comando inicia a implementação do objeto de definição de cliente na variável $CSID para a coleção denominada Coleção Geral de Computadores.

Parâmetros

-ClientSetting

Especifica um objeto de definição de cliente. Para obter um objeto de definição de cliente, utilize o cmdlet Get-CMClientSetting .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ClientSettingId

Especifica o ID de um objeto de definição de cliente.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClientSettingName

Especifica o nome de um objeto de definição de cliente.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Collection

Especifica um objeto de coleção do Configuration Manager. Para obter um objeto de coleção, utilize o cmdlet Get-CMDeviceCollection . O Configuration Manager aplica as definições de cliente aos membros desta coleção.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CollectionId

Especifica o ID de uma coleção do Configuration Manager. O Configuration Manager aplica as definições de cliente aos membros desta coleção.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifica o nome de uma coleção do Configuration Manager. O Configuration Manager aplica as definições de cliente aos membros desta coleção.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object