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
RELATED LINKS
Aprovação-CMUserDeviceAffinityRequest
Deny-CMUserDeviceAffinityRequest
Get-CMUserDeviceAffinityRequest