Freigeben über


Get-CMUser

Ruft einen Configuration Manager-Benutzer ab.

Syntax

Get-CMUser
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUser
   -CollectionId <String>
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUser
   -CollectionName <String>
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUser
   -InputObject <IResultObject>
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUser
   -ResourceId <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-CMUser ruft ein Configuration Manager-Benutzerobjekt ab.

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: Abrufen eines Benutzers anhand des Namens

PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\username01"

Dieser Befehl ruft den Benutzer username01 aus der Sammlung Alle Benutzer ab.

Beispiel 2: Übergeben einer Sammlung und Abrufen eines Benutzers aus dieser Sammlung

PS XYZ:\> Get-CMCollection -Name "All Users" | Get-CMUser -Name "Contoso\testuser01"

Dieser Befehl ruft das Auflistungsobjekt mit dem Namen Alle Benutzer ab und verwendet den Pipelineoperator, um das Objekt an Get-CMUser zu übergeben, wodurch der Benutzer testuser01 aus dem Auflistungsobjekt abgerufen wird.

Parameter

-CollectionId

Gibt die ID einer Benutzersammlung an.

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

-CollectionName

Gibt den Namen einer Benutzersammlung an.

Typ:String
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

-InputObject

Gibt ein Auflistungsobjekt an. Verwenden Sie zum Abrufen eines Auflistungsobjekts das Cmdlet Get-CMCollection .

Typ:IResultObject
Aliase:Collection
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Benutzers an.

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

-ResourceId

Gibt die Ressourcen-ID eines Benutzers an.

Typ:Int32
Aliase:Id, UserId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject