Start-CMClientSettingDeployment

  • Referencia
Módulo:
ConfigurationManager

(En desuso) Implementa la configuración de cliente en los dispositivos de una colección.

Syntax

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

El cmdlet Start-CMClientSettingDeployment implementa la configuración de cliente en los dispositivos de una colección Configuration Manager. Especifique el objeto de configuración de cliente mediante su nombre o identificador, o bien puede usar el cmdlet Get-CMClientSetting para obtener un objeto de configuración de cliente. Especifique la colección a la que aplicar la configuración mediante su nombre o identificador, o bien puede usar el cmdlet Get-CMDeviceCollection para obtener una colección de dispositivos.

Para obtener más información sobre la configuración de cliente, consulte Acerca de la configuración de cliente en Configuration Manager.

Importante

A partir de la versión 2107, este cmdlet está en desuso y puede quitarse en una versión futura. En su lugar, use el cmdlet New-CMClientSettingDeployment .

Ejemplos

Ejemplo 1: Implementación de un objeto de configuración de cliente mediante su identificador en una colección con nombre

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

Este comando inicia la implementación del objeto de configuración de cliente que tiene el identificador CSI1023 para la colección denominada Colección general de equipos.

Ejemplo 2: Implementación de un objeto de configuración de cliente mediante una variable

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

El primer comando obtiene un objeto de configuración de cliente que tiene el identificador CSI1023 y lo guarda en la variable $CSID.

El segundo comando inicia la implementación del objeto de configuración de cliente en la variable $CSID en la colección denominada Colección general de equipos.

Parámetros

-ClientSetting

Especifica un objeto de configuración de cliente. Para obtener un objeto de configuración de cliente, use el cmdlet Get-CMClientSetting .

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

-ClientSettingId

Especifica el identificador de un objeto de configuración de cliente.

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

-ClientSettingName

Especifica el nombre de un objeto de configuración de cliente.

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

-Collection

Especifica un objeto de colección Configuration Manager. Para obtener un objeto de colección, use el cmdlet Get-CMDeviceCollection . Configuration Manager aplica la configuración de cliente a los miembros de esta colección.

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

-CollectionId

Especifica el identificador de una colección de Configuration Manager. Configuration Manager aplica la configuración de cliente a los miembros de esta colección.

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

-CollectionName

Especifica el nombre de una colección de Configuration Manager. Configuration Manager aplica la configuración de cliente a los miembros de esta colección.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object