Partilhar via


Get-CMUserDeviceAffinity

SYNOPSIS

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

SYNTAX

SearchByUserNameMandatory (Padrão)

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

O cmdlet Get-CMUserDeviceAffinity obtém uma ou mais afinidades do dispositivo de utilizador no Gestor de Configuração. As afinidades do dispositivo do utilizador são as relações entre um dispositivo e os seus utilizadores primários. Para obter mais informações, consulte utilizadores e dispositivos Link com afinidade do dispositivo do utilizador no Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Obtenha afinidades do dispositivo de utilizador pelo nome de utilizador

Este comando obtém qualquer afinidade do 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 de atributos devolvidos com o cmdlet Select-Object. Pode utilizar este exemplo para descobrir rapidamente quais os dispositivos que um utilizador específico utiliza 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: Obtenha afinidades do dispositivo de utilizador pelo ID do utilizador

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

Get-CMUserDeviceAffinity -UserID "2063597981"

Exemplo 4: Obtenha uma afinidade do dispositivo de utilizador para um nome de dispositivo

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

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

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

Este comando obtém a afinidade do dispositivo do utilizador para o dispositivo com 16780642 de identificação de recursos .

Get-CMUserDeviceAffinity -DeviceID "16780642"

Exemplo 6: Obter utilizadores primários para uma lista de dispositivos

Esta amostra de script mostra o utilizador principal para uma lista de dispositivos importados. Um método para obter esta lista é a partir da consola Gestor de Configuração, no nó dispositivos, várias linhas selecionadas e copiar o texto (Ctrl + V). Cole os dados num ficheiro de texto simples, substitua os caracteres do separador como vírgulas , (), e 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
  }
}

A amostra do guião utiliza o Import-Csv cmdlet para obter a entrada de uma lista separada por vírgula que tem uma coluna Nome para o nome do dispositivo.

  • O primeiro foreach comando passa por cada linha a partir do ficheiro separado por vírgula. Utiliza o cmdlet Get-CMUserDeviceAffinity para obter os utilizadores primários para esse dispositivo.
  • Se houver mais de um utilizador primário do dispositivo, então escreve o nome do computador e cada utilizador numa linha separada.
  • Se houver apenas um utilizador primário do dispositivo, escreve o nome do computador e o utilizador.
  • A saída do script é uma lista simples de nomes de computador e nomes de utilizadores primários associados.

PARAMETERS

-DeviceId

Especifique um conjunto de IDs de recursos do dispositivo para obter os seus utilizadores primários.

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

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

-Nome do dispositivo

Especifique uma série de nomes do dispositivo.

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

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UserId

Especifica uma série de IDs de recursos do utilizador. Utilize este parâmetro para obter quaisquer dispositivos para os quais este utilizador seja o utilizador principal.

Type: Int32[]
Parameter Sets: SearchByUserIdMandatory
Aliases:

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

-UserName

Especifique uma série de nomes de utilizador. Utilize este parâmetro para obter quaisquer dispositivos para os quais este utilizador seja o utilizador principal.

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

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject[]#SMS_UserMachineRelationship

IResultObject#SMS_UserMachineRelationship

NOTAS

Aprovação-CMUserDeviceAffinityRequest

Deny-CMUserDeviceAffinityRequest

Get-CMUserDeviceAffinityRequest

Importação-CMUserDeviceAffinity

Ligue os utilizadores e dispositivos com a afinidade do dispositivo de utilizador no Gestor de Configuração