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 beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. 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"

Mit diesem Befehl wird der Benutzer mit dem Namen "username01" aus der Sammlung "Alle Benutzer" abgerufen.

Beispiel 2: Übergeben einer Sammlung und Abrufen eines Benutzers daraus

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

Dieser Befehl ruft das Auflistungsobjekt mit dem Namen "Alle Benutzer" ab und übergibt das Objekt mithilfe des Pipelineoperators an "Get-CMUser", wodurch der Benutzer "testuser01" aus dem Auflistungsobjekt abgerufen wird.

Parameter

-CollectionId

Gibt die ID einer Benutzersammlung an.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Gibt den Namen einer Benutzersammlung an.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Namen eines Benutzers an.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-ResourceId

Gibt die Ressourcen-ID eines Benutzers an.

Type:Int32
Aliases:Id, UserId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject