Share via

Add-CMUserAffinityToDevice

  • Referência
Módulo:
ConfigurationManager

Adiciona um usuário primário a um ou mais dispositivos na hierarquia Configuration Manager.

Syntax

Add-CMUserAffinityToDevice
   -DeviceName <String[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserAffinityToDevice
   -DeviceId <Int32[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Add-CMUserAffinityToDevice associa os dispositivos a um usuário primário no Configuration Manager. Você pode especificar os dispositivos a serem associados ao usuário primário por seus nomes ou IDs. Você pode especificar o usuário primário pelo nome ou ID.

A afinidade do dispositivo de usuário é um método de associação de um usuário a um ou mais dispositivos especificados. Isso permite implantar aplicativos em um usuário sem o requisito de saber o nome de todos os dispositivos do usuário. Em vez de implantar o aplicativo em todos os dispositivos de um usuário, você implanta o aplicativo no usuário e o aplicativo é instalado automaticamente em todos os dispositivos associados a esse usuário.

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: Adicionar um usuário primário a um dispositivo

PS XYZ:\>Add-CMUserAffinityToDevice -DeviceName "CMCEN-DIST-02" -UserId "2063597981"

Esse comando adiciona o usuário primário que tem a ID 2063597981 ao dispositivo chamado CMCEN-DIST-02.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DeviceId

Especifica uma matriz de IDs dos dispositivos que você deseja associar ao usuário primário.

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

-DeviceName

Especifica uma matriz de nomes dos dispositivos que você deseja associar ao usuário primário.

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

-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

-UserId

Especifica a ID de um usuário.

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

-UserName

Especifica o nome do usuário primário.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

System.Object