Dela via

Get-CMUserDeviceAffinity

  • Artikel

SYNOPSIS

Hämta relationerna mellan en enhet och dess primära användare.

SYNTAX

SearchByUserNameMandatory (standard)

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

Cmdleten Get-CMUserDeviceAffinity hämtar en eller flera affiniteter mellan användare och enheter i Konfigurationshanteraren. Affinitet mellan användare och enhet är relationerna mellan en enhet och dess primära användare. Mer information finns i Länka användare och enheter med mappning mellan användare och enhet i Konfigurationshanteraren.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta affiniteter mellan användare och enheter efter användarnamn

Det här kommandot hämtar alla användarenhets affiniteter för användaren contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Exempel 2: Hämta enheter för en viss användare

Det här exemplet liknar det första, men minskar den returnerade listan med attribut med cmdleten Select-Object. Du kan använda det här exemplet för att snabbt hitta vilka enheter en specifik användare regelbundet använder. Det här exemplet visar utdata i det här ändrade formatet.

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

Exempel 3: Hämta användarenhets affinier efter användar-ID

Det här kommandot hämtar alla användarenhetstilldelningar för användaren med resurs-ID:t 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Exempel 4: Hämta mappning mellan användare och enhet för ett enhetsnamn

Det här kommandot hämtar mappning mellan användare och enhet för enheten med namnet CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Exempel 5: Hämta mappning mellan användare och enhet för ett enhets-ID

Det här kommandot hämtar mappning mellan användare och enhet med resurs-ID:t 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Exempel 6: Hämta primära användare för en lista över enheter

Det här skriptexempel visar den primära användaren för en importerad lista över enheter. En metod för att hämta den här listan är Konfigurationshanteraren-konsolen, i noden Enheter väljer du flera rader och kopierar texten (Ctrl + V). Klistra in data i en oformaterad textfil, ersätt tabbtecken som kommatecken ( ) och , spara dem sedan som 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
  }
}

Skriptexempel använder cmdleten Import-Csv för att ta indata från en kommaavgränsad lista som har en Namn-kolumn för enhetsnamnet.

  • Det första foreach kommandot loopar igenom varje rad från den kommaavgränsade filen. Den använder cmdleten Get-CMUserDeviceAffinity för att hämta de primära användarna för den enheten.
  • Om det finns fler än en primär användare av enheten skriver den datornamnet och varje användare på en separat rad.
  • Om det bara finns en primär användare av enheten skriver den datornamnet och användaren.
  • Skriptets utdata är en enkel lista över datornamn och associerade primära användarnamn.

PARAMETERS

-DeviceId

Ange en matris med enhetsresurs-ID:er för att hämta sina primära användare.

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

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

-DeviceName

Ange en matris med enhetsnamn.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UserId

Anger en matris med användarresurs-ID: er. Använd den här parametern för att hämta alla enheter som den här användaren är den primära användaren för.

Type: Int32[]
Parameter Sets: SearchByUserIdMandatory
Aliases:

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

-UserName

Ange en matris med användarnamn. Använd den här parametern för att hämta alla enheter som den här användaren är den primära användaren för.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject[]#SMS_UserMachineRelationship

IResultObject#SMS_UserMachineRelationship

ANTECKNINGAR

Approve-CMUserDeviceAffinityRequest

Deny-CMUserDeviceAffinityRequest

Get-CMUserDeviceAffinityRequest

Import-CMUserDeviceAffinity

Länka användare och enheter med mappning mellan användare och enhet i Konfigurationshanteraren