Share via

Get-CMUserDeviceAffinity

  • Referência
Módulo:
ConfigurationManager

Obtenha as relações entre um dispositivo e seus usuários primários.

Syntax

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 de usuário em Configuration Manager. As afinidades do dispositivo de usuário são as relações entre um dispositivo e seus usuários primários. Para obter mais informações, consulte Vincular usuários e dispositivos com afinidade de dispositivo de usuário em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Obter afinidades de dispositivo de usuário por nome de usuário

Esse comando obtém todas as afinidades de dispositivo de usuário para o usuário contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Exemplo 2: Obter dispositivos para um determinado usuário

Este exemplo é semelhante ao primeiro, mas reduz a lista retornada de atributos com o cmdlet Select-Object . Você pode usar este exemplo para localizar rapidamente quais dispositivos um usuário específico usa regularmente. Este exemplo mostra a saída 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 de usuário pela ID do usuário

Esse comando obtém todas as afinidades de dispositivo de usuário para o usuário com a ID do recurso 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Exemplo 4: obter uma afinidade de dispositivo de usuário para um nome de dispositivo

Esse comando obtém a afinidade do dispositivo de usuário para o dispositivo chamado CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Exemplo 5: obter uma afinidade de dispositivo de usuário para uma ID do dispositivo

Esse comando obtém a afinidade do dispositivo de usuário para o dispositivo com 16780642 de ID do recurso.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Exemplo 6: obter usuários primários para uma lista de dispositivos

Este exemplo de script exibe o usuário primário para uma lista importada de dispositivos. Um método para obter essa lista é do console Configuration Manager, no nó Dispositivos, selecione várias linhas e copie o texto (Ctrl + V). Cole os dados em um arquivo de texto simples, substitua os caracteres da guia como vírgulas (,) e salve-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 usa o cmdlet Import-Csv para obter a entrada de uma lista separada por vírgulas que tem uma coluna Name para o nome do dispositivo.

  • O primeiro foreach comando passa por cada linha do arquivo separado por vírgula. Ele usa o cmdlet Get-CMUserDeviceAffinity para obter os usuários primários desse dispositivo.
  • Se houver mais de um usuário primário do dispositivo, ele gravará o nome do computador e cada usuário em uma linha separada.
  • Se houver apenas um usuário primário do dispositivo, ele gravará o nome do computador e o usuário.
  • A saída do script é uma lista simples de nomes de computador e nomes de usuário primários associados.

Parâmetros

-DeviceId

Especifique uma matriz de IDs de recursos de dispositivo para obter seus usuários primários.

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

-DeviceName

Especifique uma matriz de nomes de dispositivo.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-ShowApprovedOnly

Adicione esse parâmetro para filtrar afinidades não aprovadas.

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

-UserId

Especifica uma matriz de IDs de recurso do usuário. Use esse parâmetro para obter todos os dispositivos para os quais esse usuário é o usuário principal.

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

-UserName

Especifique uma matriz de nomes de usuário. Use esse parâmetro para obter todos os dispositivos para os quais esse usuário é o usuário principal.

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

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_UserMachineRelationship classe WMI do servidor.