Get-CMUserDeviceAffinity

Sintaxe

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>]

Description

O cmdlet Get-CMUserDeviceAffinity obtém uma ou mais afinidades de dispositivo do utilizador no Configuration Manager. As afinidades de dispositivo do utilizador são as relações entre um dispositivo e os respetivos utilizadores principais. Para obter mais informações, veja Ligar utilizadores e dispositivos com afinidade de dispositivo do utilizador no Configuration Manager.

Exemplos

Exemplo 1: Obter afinidades de dispositivo do utilizador por nome de utilizador

Este comando obtém quaisquer afinidades de dispositivo do utilizador para o utilizador contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Exemplo 2: Obter dispositivos para um determinado utilizador

Este exemplo é semelhante ao primeiro, mas reduz a lista devolvida de atributos com o cmdlet Select-Object . Pode utilizar este exemplo para localizar rapidamente os dispositivos que um utilizador específico utiliza regularmente. Este exemplo mostra o resultado neste formato modificado.

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

Exemplo 3: Obter afinidades de dispositivo do utilizador por ID de utilizador

Este comando obtém quaisquer afinidades de dispositivo do utilizador para o utilizador com o ID de recurso 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Exemplo 4: Obter uma afinidade de dispositivo de utilizador para um nome de dispositivo

Este comando obtém a afinidade de dispositivo do utilizador para o dispositivo com o nome CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Exemplo 5: Obter uma afinidade de dispositivo do utilizador para um ID de dispositivo

Este comando obtém a afinidade de dispositivo do utilizador para o dispositivo com o ID de recurso 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Exemplo 6: Obter utilizadores principais para uma lista de dispositivos

Este exemplo de script apresenta o utilizador principal de uma lista importada de dispositivos. Um método para obter esta lista é a partir da consola do Configuration Manager, no nó Dispositivos, selecione múltiplas linhas e copie o texto (Ctrl + V). Cole os dados num ficheiro de texto simples, substitua os carateres de tabulação como vírgulas (,) e, em seguida, guarde-os como 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
  }
}

O exemplo de script utiliza o cmdlet Import-Csv para obter entradas de uma lista separada por vírgulas que tem uma coluna Nome para o nome do dispositivo.

• O primeiro foreach comando percorre cada linha a partir do ficheiro separado por vírgulas. Utiliza o cmdlet Get-CMUserDeviceAffinity para obter os utilizadores principais desse dispositivo.
• Se existirem mais do que um utilizador primário do dispositivo, este escreve o nome do computador e cada utilizador numa linha separada.
• Se existir apenas um utilizador principal do dispositivo, este escreve o nome do computador e o utilizador.
• O resultado do script é uma lista simples de nomes de computadores e nomes de utilizadores primários associados.

Parâmetros

-DeviceId

-DeviceName

-DisableWildcardHandling

-ForceWildcardHandling

-ShowApprovedOnly

-UserId

-UserName

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_UserMachineRelationship classe WMI de servidor.

Links Relacionados

• Approve-CMUserDeviceAffinityRequest
• Deny-CMUserDeviceAffinityRequest
• Get-CMUserDeviceAffinityRequest
• Import-CMUserDeviceAffinity
• Ligar utilizadores e dispositivos com a afinidade dispositivo/utilizador no Configuration Manager