Freigeben über

Add-CMUserAffinityToDevice

  • Referenz
Modul:
ConfigurationManager

Fügt einem oder mehreren Geräten in der Configuration Manager-Hierarchie einen primären Benutzer hinzu.

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

Beschreibung

Das Cmdlet Add-CMUserAffinityToDevice ordnet die Geräte einem primären Benutzer in Configuration Manager zu. Sie können die Geräte angeben, die dem primären Benutzer anhand ihres Namens oder ihrer IDs zugeordnet werden sollen. Sie können den primären Benutzer anhand seines Namens oder seiner ID angeben.

Affinität zwischen Benutzer und Gerät ist eine Methode zum Zuordnen eines Benutzers zu einem oder mehreren angegebenen Geräten. Auf diese Weise können Sie Anwendungen für einen Benutzer bereitstellen, ohne dass der Name aller Geräte des Benutzers bekannt sein muss. Anstatt die Anwendung auf allen Geräten eines Benutzers bereitzustellen, stellen Sie die Anwendung für den Benutzer bereit, und die Anwendung wird automatisch auf allen Geräten installiert, die diesem Benutzer zugeordnet sind.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Hinzufügen eines primären Benutzers zu einem Gerät

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

Dieser Befehl fügt dem Gerät mit dem Namen CMCEN-DIST-02 den primären Benutzer mit der ID 2063597981 hinzu.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceId

Gibt ein Array von IDs der Geräte an, die Sie dem primären Benutzer zuordnen möchten.

Typ:Int32[]
Aliase:ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceName

Gibt ein Array von Namen der Geräte an, die Sie dem primären Benutzer zuordnen möchten.

Typ:String[]
Aliase:ResourceName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserId

Gibt die ID eines Benutzers an.

Typ:Int32[]
Aliase:UserIds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

Gibt den Namen des primären Benutzers an.

Typ:String[]
Aliase:UserNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object