Partilhar via


Start-CMClientSettingDeployment

SYNOPSIS

(Precatado) Implementa as definições do cliente em dispositivos numa coleção.

SYNTAX

SearchByClientSettingName_CollectionValue (Predefinição)

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

SearchByClientSettingValue_CollectionId

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

SearchByClientSettingValue_CollectionName

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

SearchByClientSettingValue_CollectionValue

Start-CMClientSettingDeployment -ClientSetting <IResultObject> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingId_CollectionId

Start-CMClientSettingDeployment -ClientSettingId <String> -CollectionId <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingId_CollectionName

Start-CMClientSettingDeployment -ClientSettingId <String> -CollectionName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingId_CollectionValue

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

SearchByClientSettingName_CollectionId

Start-CMClientSettingDeployment -ClientSettingName <String> -CollectionId <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingName_CollectionName

Start-CMClientSettingDeployment -ClientSettingName <String> -CollectionName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

O cmdlet Start-CMClientSettingDeployment implementa as definições do cliente em dispositivos numa coleção do Gestor de Configuração. Especifique o objeto de definição do cliente usando o seu nome ou ID, ou pode utilizar o cmdlet Get-CMClientSetting para obter um objeto de definição de cliente. Especifique a coleção para aplicar as definições utilizando o seu nome ou ID, ou pode utilizar o cmdlet Get-CMDeviceCollection para obter uma recolha do dispositivo.

Para obter mais informações sobre as definições do cliente, consulte Sobre Definições de clientes no Gestor de Configuração.

Importante

A partir da versão 2107, este cmdlet é depreciado e pode ser removido numa versão futura. Em vez disso, utilize o cmdlet New-CMClientSettingDeployment.

EXAMPLES

Exemplo 1: Implementar um objeto de definição de cliente usando o seu ID para uma coleção nomeada

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

Este comando inicia a implementação do objeto de definição do cliente que tem o ID CSI1023 para a coleção denominada General Computer Collection.

Exemplo 2: Implementar um objeto de definição de cliente utilizando 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 implantação do objeto de definição do cliente no $CSID variável para a coleção denominada General Computer Collection.

PARAMETERS

-ClientesSo

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

Type: IResultObject
Parameter Sets: SearchByClientSettingValue_CollectionId, SearchByClientSettingValue_CollectionName, SearchByClientSettingValue_CollectionValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ClienteSettingId

Especifica a identificação de um objeto de definição de cliente.

Type: String
Parameter Sets: SearchByClientSettingId_CollectionId, SearchByClientSettingId_CollectionName, SearchByClientSettingId_CollectionValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClientesettingName

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

Type: String
Parameter Sets: SearchByClientSettingName_CollectionValue, SearchByClientSettingName_CollectionId, SearchByClientSettingName_CollectionName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Coleção

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

Type: IResultObject
Parameter Sets: SearchByClientSettingName_CollectionValue, SearchByClientSettingValue_CollectionValue, SearchByClientSettingId_CollectionValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-CollectionId

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

Type: String
Parameter Sets: SearchByClientSettingValue_CollectionId, SearchByClientSettingId_CollectionId, SearchByClientSettingName_CollectionId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Nome de coleção

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

Type: String
Parameter Sets: SearchByClientSettingValue_CollectionName, SearchByClientSettingId_CollectionName, SearchByClientSettingName_CollectionName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Get-CMClientSetting

Get-CMDeviceCollection