Partager via

Start-CMClientSettingDeployment

  • Référence
Module:
ConfigurationManager

(Déconseillé) Déploie les paramètres du client sur les appareils d’un regroupement.

Syntaxe

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

L’applet de commande Start-CMClientSettingDeployment déploie les paramètres du client sur les appareils d’un regroupement Configuration Manager. Spécifiez l’objet de paramètre client à l’aide de son nom ou de son ID, ou vous pouvez utiliser l’applet de commande Get-CMClientSetting pour obtenir un objet de paramètre client. Spécifiez la collection à laquelle appliquer les paramètres à l’aide de son nom ou de son ID, ou vous pouvez utiliser l’applet de commande Get-CMDeviceCollection pour obtenir un regroupement d’appareils.

Pour plus d’informations sur les paramètres client, consultez À propos des paramètres client dans Configuration Manager.

Importante

À compter de la version 2107, cette applet de commande est déconseillée et peut être supprimée dans une version ultérieure. Utilisez plutôt l’applet de commande New-CMClientSettingDeployment .

Exemples

Exemple 1 : Déployer un objet de paramètre client à l’aide de son ID dans une collection nommée

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

Cette commande démarre le déploiement de l’objet de paramètre client qui a l’ID CSI1023 pour le regroupement nommé General Computer Collection.

Exemple 2 : Déployer un objet de paramètre client à l’aide d’une variable

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

La première commande obtient un objet de paramètre client qui a l’ID CSI1023 et l’enregistre dans la variable $CSID.

La deuxième commande démarre le déploiement de l’objet de paramètre client dans la variable $CSID vers le regroupement nommé General Computer Collection.

Paramètres

-ClientSetting

Spécifie un objet de paramètre client. Pour obtenir un objet de paramètre client, utilisez l’applet de commande Get-CMClientSetting .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ClientSettingId

Spécifie l’ID d’un objet de paramètre client.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientSettingName

Spécifie le nom d’un objet de paramètre client.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Collection

Spécifie un objet de collection Configuration Manager. Pour obtenir un objet de collection, utilisez l’applet de commande Get-CMDeviceCollection . Configuration Manager applique les paramètres du client aux membres de ce regroupement.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CollectionId

Spécifie l’ID d’une collection Configuration Manager. Configuration Manager applique les paramètres du client aux membres de ce regroupement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifie le nom d’une collection Configuration Manager. Configuration Manager applique les paramètres du client aux membres de ce regroupement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object