Get-CMUserDeviceAffinity
SYNOPSIS
Uzyskiwanie relacji między urządzeniem i jego użytkownikami podstawowymi.
SYNTAX
SearchByUserNameMandatory (ustawienie domyślne)
Get-CMUserDeviceAffinity -UserName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByDeviceIdMandatory
Get-CMUserDeviceAffinity -DeviceId <Int32[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByDeviceNameMandatory
Get-CMUserDeviceAffinity -DeviceName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUserIdMandatory
Get-CMUserDeviceAffinity -UserId <Int32[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
Polecenie cmdlet Get-CMUserDeviceAffinity pobiera co najmniej jedną koligacji urządzenia użytkownika w Menedżer konfiguracji. Koligacja urządzenia użytkownika to relacje między urządzeniem i jego użytkownikami podstawowymi. Aby uzyskać więcej informacji, zobacz Łączenie użytkowników i urządzeń z koligacjąurządzenia użytkownika w Menedżer konfiguracji .
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\>
. Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Uzyskiwanie koligacji urządzenia użytkownika według nazwy użytkownika
To polecenie pobiera koligacji urządzenia użytkownika dla użytkownika contoso\jqpublic.
Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"
Przykład 2: Uzyskiwanie urządzeń dla danego użytkownika
Ten przykład jest podobny do pierwszego, ale zmniejsza zwracaną listę atrybutów za pomocą polecenia cmdlet Select-Object. Możesz użyć tego przykładu, aby szybko znaleźć urządzenia, z których określony użytkownik regularnie korzysta. W tym przykładzie pokazano dane wyjściowe w tym zmodyfikowanym formacie.
PS XYZ:\> $user = "contoso\jqpublic"
PS XYZ:\> Get-CMUserDeviceAffinity -UserName $user | Select-Object ResourceName
ResourceName
------------
PUYALLUP01
KULSHAN02
TAHOMA42
Przykład 3: Uzyskiwanie koligacji urządzenia użytkownika według identyfikatora użytkownika
To polecenie pobiera wszystkie koligacji urządzenia użytkownika dla użytkownika z identyfikatorem zasobu 2063597981.
Get-CMUserDeviceAffinity -UserID "2063597981"
Przykład 4. Uzyskiwanie koligacji urządzenia użytkownika dla nazwy urządzenia
To polecenie pobiera koligacja urządzenia użytkownika dla urządzenia o nazwie CMCEN-DIST02.
Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"
Przykład 5. Uzyskiwanie koligacji urządzenia użytkownika dla identyfikatora urządzenia
To polecenie pobiera koligacja urządzenia użytkownika dla urządzenia z identyfikatorem zasobu 16780642.
Get-CMUserDeviceAffinity -DeviceID "16780642"
Przykład 6: uzyskiwanie użytkowników podstawowych dla listy urządzeń
Ten przykładowy skrypt wyświetla użytkownika podstawowego dla zaimportowanych list urządzeń. Jedną z metod uzyskania tej listy jest wybranie z konsoli Menedżer konfiguracji, w węźle Urządzenia wielokrotne zaznaczenie wielu wierszy i skopiowanie tekstu (Ctrl + V). Wklej dane do pliku w postaci zwykłego tekstu, zastąp znaki tabuły przecinkami (), a następnie zapisz je jako ,
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
}
}
Przykładowy skrypt używa Import-Csv cmdlet do pobierania danych wejściowych z listy rozdzielanych przecinkami, która zawiera kolumnę Name (Nazwa) dla nazwy urządzenia.
- Pierwsze polecenie
foreach
przechodzi przez każdy wiersz w pętli z pliku rozdzielanych przecinkami. Używa on polecenia cmdlet Get-CMUserDeviceAffinity w celu uzyskania podstawowych użytkowników tego urządzenia. - Jeśli urządzenie ma więcej niż jednego użytkownika podstawowego, zapisuje ono nazwę komputera i każdego użytkownika w osobnym wierszu.
- Jeśli urządzenie ma tylko jednego użytkownika podstawowego, zapisuje nazwę komputera i użytkownika.
- Dane wyjściowe skryptu to prosta lista nazw komputerów i skojarzonych nazw użytkowników podstawowych.
PARAMETERS
-DeviceId
Określ tablicę identyfikatorów zasobów urządzeń, aby uzyskać ich użytkowników podstawowych.
Type: Int32[]
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeviceName (Nazwa urządzenia)
Określ tablicę nazw urządzeń.
Type: String[]
Parameter Sets: SearchByDeviceNameMandatory
Aliases: ResourceName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserId
Określa tablicę identyfikatorów zasobów użytkownika. Użyj tego parametru, aby pobrać wszystkie urządzenia, dla których ten użytkownik jest użytkownikiem podstawowym.
Type: Int32[]
Parameter Sets: SearchByUserIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserName
Określ tablicę nazw użytkowników. Użyj tego parametru, aby pobrać wszystkie urządzenia, dla których ten użytkownik jest użytkownikiem podstawowym.
Type: String[]
Parameter Sets: SearchByUserNameMandatory
Aliases: UniqueUserName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Brak
OUTPUTS
IResultObject[]#SMS_UserMachineRelationship
IResultObject#SMS_UserMachineRelationship
UWAGI
RELATED LINKS
Approve-CMUserDeviceAffinityRequest
Deny-CMUserDeviceAffinityRequest
Get-CMUserDeviceAffinityRequest
Łączenie użytkowników i urządzeń z koligacją urządzenia użytkownika w Menedżer konfiguracji