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