Delen via

Get-CMUserDeviceAffinity

  • Artikel

SYNOPSIS

De relaties tussen een apparaat en de primaire gebruikers ervan op te halen.

SYNTAX

SearchByUserNameMandatory (standaard)

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

De cmdlet Get-CMUserDeviceAffinity krijgt een of meer gebruikersaffiniteiten voor apparaten in Configuration Manager. Gebruikersapparaat-affiniteiten zijn de relaties tussen een apparaat en de primaire gebruikers. Zie Gebruikers en apparaten koppelen met affiniteit tussen gebruikers en apparaten in Configuration Manager.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: affiniteit tussen gebruikers en apparaten op gebruikersnaam

Met deze opdracht worden alle gebruikersaffiniteiten voor het apparaat voor de gebruiker contoso\jqpublic opsqpubliceerd.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Voorbeeld 2: Apparaten voor een bepaalde gebruiker op halen

Dit voorbeeld is vergelijkbaar met de eerste, maar vermindert de geretourneerde lijst met kenmerken met de cmdlet Select-Object. U kunt dit voorbeeld gebruiken om snel te vinden welke apparaten een specifieke gebruiker regelmatig gebruikt. In dit voorbeeld ziet u de uitvoer in deze gewijzigde indeling.

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

Voorbeeld 3: affiniteit tussen gebruikers en apparaten op gebruikers-id

Met deze opdracht worden alle gebruikersapparaat-affiniteiten voor de gebruiker met de resource-id 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Voorbeeld 4: Affiniteit tussen gebruikers en apparaten voor een apparaatnaam

Met deze opdracht wordt de gebruikersapparaat-affiniteit voor het apparaat met de naam CMCEN-DIST02 opgeslagen.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Voorbeeld 5: Affiniteit tussen gebruikers en apparaten voor een apparaat-id

Met deze opdracht wordt de gebruikersapparaat-affiniteit voor het apparaat met de resource-id 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Voorbeeld 6: Primaire gebruikers voor een lijst met apparaten op halen

In dit voorbeeldscript wordt de primaire gebruiker voor een geïmporteerde lijst met apparaten weergegeven. Een methode om deze lijst op te halen is via de Configuration Manager-console, in het knooppunt Apparaten meerdere rijen selecteren en de tekst kopiëren (Ctrl + V). Plak de gegevens in een bestand met tekst zonder opmaak, vervang de tabtekens door komma's ( ) en sla deze , op als 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
  }
}

In het voorbeeldscript wordt de Import-Csv cmdlet gebruikt om invoer op te nemen uit een door komma's gescheiden lijst met een kolom Naam voor de apparaatnaam.

  • De eerste opdracht loopt door elke regel van het bestand met foreach door komma's gescheiden bestanden. De cmdlet Get-CMUserDeviceAffinity wordt gebruikt om de primaire gebruikers voor dat apparaat op te halen.
  • Als er meer dan één primaire gebruiker van het apparaat is, worden de computernaam en elke gebruiker op een afzonderlijke regel geschreven.
  • Als er slechts één primaire gebruiker van het apparaat is, worden de computernaam en de gebruiker geschreven.
  • De uitvoer van het script is een eenvoudige lijst met computernamen en bijbehorende primaire gebruikersnamen.

PARAMETERS

-DeviceId

Geef een matrix met apparaatresource-ID's op om hun primaire gebruikers op te halen.

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

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

-DeviceName

Geef een matrix met apparaatnamen op.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UserId

Hiermee geeft u een matrix van gebruikersresource-ID's op. Gebruik deze parameter om apparaten op te halen waarvoor deze gebruiker de primaire gebruiker is.

Type: Int32[]
Parameter Sets: SearchByUserIdMandatory
Aliases:

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

-GebruikersNaam

Geef een matrix met gebruikersnamen op. Gebruik deze parameter om apparaten op te halen waarvoor deze gebruiker de primaire gebruiker is.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Geen

OUTPUTS

IResultObject[]#SMS_UserMachineRelationship

IResultObject#SMS_UserMachineRelationship

OPMERKINGEN

Approve-CMUserDeviceAffinityRequest

Deny-CMUserDeviceAffinityRequest

Get-CMUserDeviceAffinityRequest

Import-CMUserDeviceAffinity

Gebruikers en apparaten koppelen aan gebruikersapparaat-affiniteit in Configuration Manager