Get-CMUserDeviceAffinity
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-Websitelaufwerk aus, z. PS XYZ:\>
B. . 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 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.
Type: | Int32[] |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceName
Geben Sie ein Array von Gerätenamen an.
Type: | String[] |
Aliases: | ResourceName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowApprovedOnly
Fügen Sie diesen Parameter hinzu, um nicht genehmigte Affinitäten herauszufiltern.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Aliases: | UniqueUserName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Eingaben
None
Ausgaben
IResultObject[]
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_UserMachineRelationship WMI-Serverklasse.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für