Partager via

Add-CMUserAffinityToDevice

  • Référence
Module:
ConfigurationManager

Ajoute un utilisateur principal à un ou plusieurs appareils de la hiérarchie Configuration Manager.

Syntaxe

Add-CMUserAffinityToDevice
   -DeviceName <String[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserAffinityToDevice
   -DeviceId <Int32[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Add-CMUserAffinityToDevice associe les appareils à un utilisateur principal dans Configuration Manager. Vous pouvez spécifier les appareils à associer à l’utilisateur principal par leur nom ou ID. Vous pouvez spécifier l’utilisateur principal par son nom ou son ID.

L’affinité entre l’utilisateur et l’appareil est une méthode permettant d’associer un utilisateur à un ou plusieurs appareils spécifiés. Cela vous permet de déployer des applications sur un utilisateur sans avoir à connaître le nom de tous les appareils de l’utilisateur. Au lieu de déployer l’application sur tous les appareils d’un utilisateur, vous déployez l’application sur l’utilisateur et l’application s’installe automatiquement sur tous les appareils associés à cet utilisateur.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Ajouter un utilisateur principal à un appareil

PS XYZ:\>Add-CMUserAffinityToDevice -DeviceName "CMCEN-DIST-02" -UserId "2063597981"

Cette commande ajoute l’utilisateur principal qui a l’ID 2063597981 à l’appareil nommé CMCEN-DIST-02.

Paramètres

-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

-DeviceId

Spécifie un tableau d’ID des appareils que vous souhaitez associer à l’utilisateur principal.

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

-DeviceName

Spécifie un tableau de noms des appareils que vous souhaitez associer à l’utilisateur principal.

Type:String[]
Alias:ResourceName
Position:Named
Valeur par défaut:None
Obligatoire:True
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

-UserId

Spécifie l’ID d’un utilisateur.

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

-UserName

Spécifie le nom de l’utilisateur principal.

Type:String[]
Alias:UserNames
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

None

Sorties

System.Object