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

Import-CMUserDeviceAffinity

Łączenie użytkowników i urządzeń z koligacją urządzenia użytkownika w Menedżer konfiguracji