Freigeben über


Add-CMDeviceAffinityToUser

Fügt einem Configuration Manager-Benutzer Geräteaffinität hinzu.

Syntax

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

Beschreibung

Das Cmdlet Add-CMDeviceAffinityToUser fügt einem Benutzer von Configuration Manager Geräteaffinität hinzu.

Die Geräteaffinität in Configuration Manager ordnet einen Benutzer einem oder mehreren Geräten zu. Anstatt Anwendungen auf allen Geräten des Benutzers bereitzustellen, stellen Sie die Anwendung für den Benutzer bereit, und Configuration Manager installiert die Anwendung automatisch auf allen Geräten, die diesem Benutzer zugeordnet sind. Durch die Geräteaffinität muss Configuration Manager nicht mehr die Namen der Geräte eines Benutzers ermitteln, bevor Sie Anwendungen für diesen Benutzer bereitstellen.

Weitere Informationen finden Sie unter Verknüpfen von Benutzern und Geräten mit Affinität zwischen Benutzer und Gerät.

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 von Geräteaffinität zu einem Benutzer nach Benutzer-ID

PS XYZ:\>Add-CMDeviceAffinityToUser -UserName "Patti Fuller" -DeviceName "WestDivUpdates05"

Dieser Befehl fügt dem Gerät mit dem Namen WestDivUpdates05 affinity für den Benutzer namens Patti Fuller 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 Gerät mithilfe einer ID an.

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

-DeviceName

Gibt ein Gerät unter Verwendung eines Namens an.

Typ:String[]
Aliase:DeviceNames
Position:Named
Standardwert:None
Erforderlich:False
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 einen Benutzer mithilfe einer ID an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

Gibt ein Array von Benutzernamen an, die dem Gerät zugeordnet werden sollen.

Typ:String[]
Aliase:UniqueUserName
Position:Named
Standardwert:None
Erforderlich:True
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