Get-SPUser

Gibt die Benutzerkonten zurück, die ein angegebenes Suchkriterium erfüllen.

Syntax

Get-SPUser
   [[-Identity] <SPUserPipeBind>]
   -Web <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Group <SPGroupPipeBind>]
   [-Limit <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SPUser gibt alle SharePoint-Benutzerkonten zurück, die dem bereich entsprechen, der durch die Identity-, Web- oder Group-Parameter angegeben wird.

Der Identity-Parameter kann den Alias eines Benutzers verwenden, um genaue Übereinstimmungen zurückzugeben.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

------------------BEISPIEL 1------------------

Get-SPUser -Web 'https://sharepoint.contoso.com' -Group 'Viewers'

In diesem Beispiel werden alle Mitglieder der SharePoint-Gruppe Viewer auf der Website https://sharepoint.contoso.comzurückgegeben.

------------------BEISPIEL 2------------------

Get-SPUser -Identity 'i:0#.w|contoso\jdoe' -Web 'https://sharepoint.contoso.com'

In diesem Beispiel wird der bestimmte Benutzer zurückgegeben, der über Windows-Ansprüche auf der Website https://sharepoint.contoso.comidentifiziert wird.

------------------BEISPIEL 3------------------

Get-SPUser -Identity 'contoso\jdoe' -Web 'https://sharepoint.contoso.com'

In diesem Beispiel wird der bestimmte Benutzer zurückgegeben, der über die klassische Windows-Authentifizierung auf der Website https://sharepoint.contoso.comidentifiziert wurde.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Group

Gibt die Benutzergruppe an, zu der der neue Benutzer gehört.

Type:SPGroupPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

Gibt die ID oder den Anmeldenamen des zurückzugebenden Benutzers an.

Der Typ muss eine gültige ID oder ein gültiger Anmeldename sein, z. B. das Format "CONTOSO\jdoe" für die klassische Windows-Authentifizierung oder "i:0#.w| CONTOSO\jdoe' für Windows-Ansprüche.

Type:SPUserPipeBind
Aliases:UserAlias
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Limit

Gibt die maximale Anzahl von Benutzern an, die zurückgegeben werden sollen. Der Standardwert lautet 500.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Web

Gibt die Website an, die als Bereich verwendet werden soll.

Der Typ muss eine gültige GUID im Format 12345678-90ab-cdef-1234-567890bcdefgh sein; einen gültigen Namen einer SharePoint Foundation-Website (z. B. MySPSite1); oder eine Instanz eines gültigen SPWeb-Objekts.

Type:SPWebPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition