Freigeben über

Get-CMUserDeviceAffinity

  • Referenz
Modul:
ConfigurationManager

Ruft die Beziehungen zwischen einem Gerät und seinen primären Benutzern ab.

Syntax

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>]

Beschreibung

Das Cmdlet Get-CMUserDeviceAffinity ruft mindestens eine Affinität zwischen Benutzer und Gerät in Configuration Manager ab. Benutzergeräteaffinitäten sind die Beziehungen zwischen einem Gerät und seinen primären Benutzern. Weitere Informationen finden Sie unter Verknüpfen von Benutzern und Geräten mit Affinität zwischen Benutzer und Gerät in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen von Benutzer-Geräteaffinitäten nach Benutzername

Dieser Befehl ruft alle Benutzergeräteaffinitäten für den Benutzer contoso\jqpublic ab.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Beispiel 2: Abrufen von Geräten für einen bestimmten Benutzer

Dieses Beispiel ähnelt dem ersten, reduziert jedoch die zurückgegebene Liste der Attribute mit dem Cmdlet Select-Object . Anhand dieses Beispiels können Sie schnell ermitteln, welche Geräte ein bestimmter Benutzer regelmäßig verwendet. Dieses Beispiel zeigt die Ausgabe in diesem geänderten Format.

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

Beispiel 3: Abrufen von Benutzer-Geräteaffinitäten nach Benutzer-ID

Dieser Befehl ruft alle Benutzergeräteaffinitäten für den Benutzer mit der Ressourcen-ID 2063597981 ab.

Get-CMUserDeviceAffinity -UserID "2063597981"

Beispiel 4: Abrufen der Affinität zwischen Benutzer und Gerät für einen Gerätenamen

Dieser Befehl ruft die Affinität zwischen Benutzer und Gerät mit dem Namen CMCEN-DIST02 ab.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Beispiel 5: Abrufen der Affinität zwischen einem Benutzer und einer Geräte-ID

Dieser Befehl ruft die Affinität zwischen Benutzer und Gerät mit Ressourcen-ID 16780642 ab.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Beispiel 6: Abrufen primärer Benutzer für eine Liste von Geräten

In diesem Skriptbeispiel wird der primäre Benutzer für eine importierte Liste von Geräten angezeigt. Eine Methode zum Abrufen dieser Liste ist über die Configuration Manager-Konsole, wählen Sie im Knoten Geräte mehrere Zeilen aus, und kopieren Sie den Text (STRG + V). Fügen Sie die Daten in eine Nur-Text-Datei ein, ersetzen Sie die Registerkartenzeichen als Kommas (,), und speichern Sie sie dann als 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
  }
}

Im Skriptbeispiel wird das Cmdlet Import-Csv verwendet, um Eingaben aus einer durch Trennzeichen getrennten Liste zu übernehmen, die die Spalte Name für den Gerätenamen enthält.

  • Der erste foreach Befehl durchläuft jede Zeile aus der durch Trennzeichen getrennten Datei. Es verwendet das Cmdlet Get-CMUserDeviceAffinity , um die primären Benutzer für dieses Gerät abzurufen.
  • Wenn mehr als ein primärer Benutzer des Geräts vorhanden ist, werden der Computername und jeder Benutzer in eine separate Zeile geschrieben.
  • Wenn nur ein primärer Benutzer des Geräts vorhanden ist, werden der Computername und der Benutzer geschrieben.
  • Die Ausgabe des Skripts ist eine einfache Liste von Computernamen und zugeordneten primären Benutzernamen.

Parameter

-DeviceId

Geben Sie ein Array von Geräteressourcen-IDs an, um ihre primären Benutzer abzurufen.

Typ:Int32[]
Aliase:ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceName

Geben Sie ein Array von Gerätenamen an.

Typ:String[]
Aliase:ResourceName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ShowApprovedOnly

Fügen Sie diesen Parameter hinzu, um nicht genehmigte Affinitäten herauszufiltern.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserId

Gibt ein Array von Benutzerressourcen-IDs an. Verwenden Sie diesen Parameter, um alle Geräte abzurufen, für die dieser Benutzer der primäre Benutzer ist.

Typ:Int32[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

Geben Sie ein Array von Benutzernamen an. Verwenden Sie diesen Parameter, um alle Geräte abzurufen, für die dieser Benutzer der primäre Benutzer ist.

Typ:String[]
Aliase:UniqueUserName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_UserMachineRelationship WMI-Serverklasse.