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
Propojení uživatelů a zařízení pomocí spřažení uživatelských zařízení v Configuration Manager