Compartilhar via

Get-CMUserDeviceAffinity

  • Referência
Módulo:
ConfigurationManager

Obtenha as relações entre um dispositivo e os respetivos utilizadores principais.

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.

Observação

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

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

Especifique uma matriz de IDs de recursos do dispositivo para obter os utilizadores principais.

Tipo:Int32[]
Aliases:ResourceId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceName

Especifique uma matriz de nomes de dispositivos.

Tipo:String[]
Aliases:ResourceName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShowApprovedOnly

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserId

Especifica uma matriz de IDs de recursos de utilizador. Utilize este parâmetro para obter os dispositivos para os quais este utilizador é o utilizador principal.

Tipo:Int32[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserName

Especifique uma matriz de nomes de utilizador. Utilize este parâmetro para obter os dispositivos para os quais este utilizador é o utilizador principal.

Tipo:String[]
Aliases:UniqueUserName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

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.