Partager via

Get-CMUserDeviceAffinity

  • Référence
Module:
ConfigurationManager

Obtenir les relations entre un appareil et ses utilisateurs principaux.

Syntaxe

Get-CMUserDeviceAffinity
   -UserName <String[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -DeviceId <Int32[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -DeviceName <String[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -UserId <Int32[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

L’applet de commande Get-CMUserDeviceAffinity obtient une ou plusieurs affinités d’appareil utilisateur dans Configuration Manager. Les affinités entre l’appareil utilisateur sont les relations entre un appareil et ses utilisateurs principaux. Pour plus d’informations, consultez Lier des utilisateurs et des appareils avec l’affinité entre utilisateurs et appareils dans Configuration Manager.

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 : Obtenir les affinités entre les appareils utilisateur par nom d’utilisateur

Cette commande obtient toutes les affinités d’appareil utilisateur pour l’utilisateur contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Exemple 2 : Obtenir des appareils pour un utilisateur donné

Cet exemple est similaire au premier, mais réduit la liste d’attributs retournée avec l’applet de commande Select-Object . Vous pouvez utiliser cet exemple pour trouver rapidement les appareils qu’un utilisateur spécifique utilise régulièrement. Cet exemple montre la sortie dans ce format modifié.

PS XYZ:\> $user = "contoso\jqpublic"
PS XYZ:\> Get-CMUserDeviceAffinity -UserName $user | Select-Object ResourceName
ResourceName
------------
PUYALLUP01
KULSHAN02
TAHOMA42

Exemple 3 : Obtenir les affinités d’appareil utilisateur par ID d’utilisateur

Cette commande obtient toutes les affinités d’appareil utilisateur pour l’utilisateur avec l’ID de ressource 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Exemple 4 : Obtenir une affinité utilisateur d’appareil pour un nom d’appareil

Cette commande obtient l’affinité utilisateur d’appareil pour l’appareil nommé CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Exemple 5 : Obtenir une affinité d’appareil utilisateur pour un ID d’appareil

Cette commande obtient l’affinité entre l’utilisateur et l’appareil avec l’ID de ressource 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Exemple 6 : Obtenir des utilisateurs principaux pour une liste d’appareils

Cet exemple de script affiche l’utilisateur principal pour une liste d’appareils importés. Une méthode pour obtenir cette liste consiste à partir de la console Configuration Manager, dans le nœud Appareils , à sélectionner plusieurs lignes et à copier le texte (Ctrl + V). Collez les données dans un fichier texte brut, remplacez les tabulations par des virgules (,), puis enregistrez-les en tant que computers.csv.

$computers = Import-Csv -Path "C:\Users\jqpublic\computers.csv"

foreach ( $computer in $computers )
{
  $uda = Get-CMUserDeviceAffinity -DeviceName $computer.Name
  
  if ( ($uda.UniqueUserName).count -gt 1 )
  {
    foreach ( $user in $uda.UniqueUserName )
    {
      Write-Host $uda.ResourceName[1] $user
    }
  }
  else
  {
    write-host $uda.ResourceName $uda.UniqueUserName
  }
}

L’exemple de script utilise l’applet de commande Import-Csv pour prendre l’entrée d’une liste séparée par des virgules qui contient une colonne Nom pour le nom de l’appareil.

  • La première foreach commande effectue une boucle dans chaque ligne du fichier séparé par des virgules. Il utilise l’applet de commande Get-CMUserDeviceAffinity pour obtenir les utilisateurs principaux de cet appareil.
  • S’il existe plusieurs utilisateurs principaux de l’appareil, il écrit le nom de l’ordinateur et chaque utilisateur sur une ligne distincte.
  • S’il n’y a qu’un seul utilisateur principal de l’appareil, il écrit le nom de l’ordinateur et l’utilisateur.
  • La sortie du script est une liste simple de noms d’ordinateurs et de noms d’utilisateur principaux associés.

Paramètres

-DeviceId

Spécifiez un tableau d’ID de ressource d’appareil pour obtenir leurs utilisateurs principaux.

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écifiez un tableau de noms d’appareils.

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:True

-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

-ShowApprovedOnly

Ajoutez ce paramètre pour filtrer les affinités non approuvées.

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 un tableau d’ID de ressource utilisateur. Utilisez ce paramètre pour obtenir tous les appareils pour lesquels cet utilisateur est l’utilisateur principal.

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

-UserName

Spécifiez un tableau de noms d’utilisateur. Utilisez ce paramètre pour obtenir tous les appareils pour lesquels cet utilisateur est l’utilisateur principal.

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

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_UserMachineRelationship classe WMI du serveur.