Get-CMUserDeviceAffinity

  • Riferimento
Modulo:
ConfigurationManager

Ottenere le relazioni tra un dispositivo e i relativi utenti primari.

Sintassi

Get-CMUserDeviceAffinity
   -UserName <String[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -DeviceId <Int32[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -DeviceName <String[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -UserId <Int32[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-CMUserDeviceAffinity ottiene una o più affinità utente-dispositivo in Configuration Manager. Le affinità utente-dispositivo sono le relazioni tra un dispositivo e i relativi utenti primari. Per altre informazioni, vedere Collegare utenti e dispositivi con affinità utente-dispositivo in Configuration Manager.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere affinità utente-dispositivo per nome utente

Questo comando ottiene qualsiasi affinità utente-dispositivo per l'utente contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Esempio 2: Ottenere i dispositivi per un determinato utente

Questo esempio è simile al primo, ma riduce l'elenco di attributi restituito con il cmdlet Select-Object . È possibile usare questo esempio per individuare rapidamente i dispositivi usati regolarmente da un utente specifico. Questo esempio mostra l'output in questo formato modificato.

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

Esempio 3: Ottenere affinità utente-dispositivo per ID utente

Questo comando ottiene qualsiasi affinità utente-dispositivo per l'utente con l'ID risorsa 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Esempio 4: Ottenere un'affinità utente-dispositivo per un nome di dispositivo

Questo comando ottiene l'affinità utente-dispositivo per il dispositivo denominato CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Esempio 5: Ottenere un'affinità utente-dispositivo per un ID dispositivo

Questo comando ottiene l'affinità utente-dispositivo per il dispositivo con ID risorsa 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Esempio 6: Ottenere gli utenti primari per un elenco di dispositivi

Questo esempio di script visualizza l'utente primario per un elenco di dispositivi importato. Un metodo per ottenere questo elenco è dalla console di Configuration Manager, nel nodo Dispositivi selezionare più righe e copiare il testo (CTRL + V). Incollare i dati in un file di testo normale, sostituire i caratteri di tabulazioni come virgole (,), quindi salvarli come 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
  }
}

L'esempio di script usa il cmdlet Import-Csv per accettare l'input da un elenco delimitato da virgole con una colonna Name per il nome del dispositivo.

  • Il primo foreach comando scorre ogni riga del file delimitato da virgole. Usa il cmdlet Get-CMUserDeviceAffinity per ottenere gli utenti primari per il dispositivo.
  • Se sono presenti più utenti primari del dispositivo, scrive il nome del computer e ogni utente in una riga separata.
  • Se è presente un solo utente primario del dispositivo, scrive il nome del computer e l'utente.
  • L'output dello script è un semplice elenco di nomi di computer e nomi utente primari associati.

Parametri

-DeviceId

Specificare una matrice di ID risorse del dispositivo per ottenere gli utenti primari.

Type:Int32[]
Aliases:ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

Specificare una matrice di nomi di dispositivo.

Type:String[]
Aliases:ResourceName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-ShowApprovedOnly

Aggiungere questo parametro per filtrare le affinità non approvate.

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

-UserId

Specifica una matrice di ID risorsa utente. Usare questo parametro per ottenere tutti i dispositivi per i quali l'utente è l'utente primario.

Type:Int32[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserName

Specificare una matrice di nomi utente. Usare questo parametro per ottenere tutti i dispositivi per i quali l'utente è l'utente primario.

Type:String[]
Aliases:UniqueUserName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_UserMachineRelationship classe WMI del server.