Condividi tramite


Add-CMUserAffinityToDevice

Aggiunge un utente primario a uno o più dispositivi nella gerarchia di Configuration Manager.

Sintassi

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>]

Descrizione

Il cmdlet Add-CMUserAffinityToDevice associa i dispositivi a un utente primario in Configuration Manager. È possibile specificare i dispositivi da associare all'utente primario in base ai relativi nomi o ID. È possibile specificare l'utente primario in base al nome o all'ID.

L'affinità utente dispositivo è un metodo per associare un utente a uno o più dispositivi specificati. In questo modo è possibile distribuire applicazioni a un utente senza dover conoscere il nome di tutti i dispositivi dell'utente. Invece di distribuire l'applicazione in tutti i dispositivi di un utente, l'applicazione viene distribuita all'utente e l'applicazione viene installata automaticamente in tutti i dispositivi associati a tale utente.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere un utente primario a un dispositivo

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

Questo comando aggiunge l'utente primario con l'ID 2063597981 al dispositivo denominato CMCEN-DIST-02.

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceId

Specifica una matrice di ID dei dispositivi che si desidera associare all'utente primario.

Tipo:Int32[]
Alias:ResourceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceName

Specifica una matrice di nomi dei dispositivi che si desidera associare all'utente primario.

Tipo:String[]
Alias:ResourceName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserId

Specifica l'ID di un utente.

Tipo:Int32[]
Alias:UserIds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserName

Specifica il nome dell'utente primario.

Tipo:String[]
Alias:UserNames
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object