Get-CMUserDeviceAffinity

SYNOPSIS

Získejte vztahy mezi zařízením a jeho primárními uživateli.

SYNTAX

SearchByUserNameMandatory (výchozí)

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

Rutina Get-CMUserDeviceAffinity získá jedno nebo více spřažení uživatelských zařízení v Configuration Manager. Spřažení uživatelských zařízení jsou vztahy mezi zařízením a jeho primárními uživateli. Další informace najdete v tématu propojení uživatelů a zařízení pomocí spřažení uživatelských zařízení v Configuration Manager.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: získání spřažení uživatelských zařízení podle uživatelského jména

Tento příkaz získá jakékoli spřažení uživatelských zařízení pro uživatele contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Příklad 2: získání zařízení pro daného uživatele

Tento příklad je podobný prvnímu, ale redukuje vrácený seznam atributů pomocí rutiny Select-Object . Tento příklad můžete použít k rychlému vyhledání zařízení, která konkrétní uživatel pravidelně používá. Tento příklad ukazuje výstup v tomto změněném formátu.

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

Příklad 3: získání spřažení uživatelských zařízení podle ID uživatele

Tento příkaz získá jakékoli spřažení uživatelských zařízení pro uživatele s ID prostředku 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Příklad 4: získání spřažení uživatelských zařízení pro název zařízení

Tento příkaz načte spřažení uživatelských zařízení pro zařízení s názvem CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Příklad 5: získání spřažení uživatelských zařízení pro ID zařízení

Tento příkaz načte spřažení uživatelských zařízení pro zařízení s ID prostředku 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Příklad 6: získání primárních uživatelů pro seznam zařízení

Tento ukázkový skript zobrazí primárního uživatele pro importovaný seznam zařízení. Jedna z metod, jak tento seznam získat, je z konzoly Configuration Manager, v uzlu zařízení , více výběrů více řádků a kopírovat text (CTRL + V). Vložte data do souboru prostého textu, nahraďte znaky tabulátoru jako čárky ( , ) a pak ji uložte 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
  }
}

Ukázka skriptu používá rutinu Import-Csv k převzetí vstupu ze seznamu odděleného čárkami, který má sloupec názvu pro název zařízení.

• První foreach příkaz projde každým řádkem ze souboru odděleného čárkami. K získání primárních uživatelů pro toto zařízení používá rutinu Get-CMUserDeviceAffinity .
• Pokud je k dispozici více než jeden primární uživatel zařízení, zapíše název počítače a každého uživatele na samostatný řádek.
• Pokud je k dispozici pouze jeden primární uživatel zařízení, zapíše název počítače a uživatele.
• Výstupem skriptu je jednoduchý seznam názvů počítačů a přidružených primárních uživatelských jmen.

PARAMETERS

– DeviceId

Pro získání primárních uživatelů zadejte pole ID prostředků zařízení.

Type: Int32[]
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Název_zařízení

Zadejte pole názvů zařízení.

Type: String[]
Parameter Sets: SearchByDeviceNameMandatory
Aliases: ResourceName

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– UserId

Určuje pole ID prostředků uživatele. Pomocí tohoto parametru můžete získat všechna zařízení, pro které je tento uživatel primárním uživatelem.

Type: Int32[]
Parameter Sets: SearchByUserIdMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserName

Zadejte pole uživatelských jmen. Pomocí tohoto parametru můžete získat všechna zařízení, pro které je tento uživatel primárním uživatelem.

Type: String[]
Parameter Sets: SearchByUserNameMandatory
Aliases: UniqueUserName

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Žádná

OUTPUTS

IResultObject [] #SMS_UserMachineRelationship

IResultObject # SMS_UserMachineRelationship

POZNÁMKY

RELATED LINKS

Schválit – CMUserDeviceAffinityRequest

Odepřít – CMUserDeviceAffinityRequest

Get-CMUserDeviceAffinityRequest

Import – CMUserDeviceAffinity

Propojení uživatelů a zařízení pomocí spřažení uživatelských zařízení v Configuration Manager