Get-SPOUser

  • Referenz
Modul:
Microsoft.Online.SharePoint.PowerShell
Gilt für::
SharePoint Online

Gibt die SharePoint Online-Benutzer- oder -Sicherheitsgruppenkonten zurück, die einem bestimmten Suchkriterium entsprechen.

Syntax

Get-SPOUser
   [-Group <String>]
   [-Limit <String>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]
Get-SPOUser
   [-Limit <String>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]
Get-SPOUser
   [-LoginName <String>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

Das Get-SPOUser-Cmdlet führt einen Abgleich mit genau einem Benutzer bzw. genau einer Sicherheitsgruppe aus.

Sie müssen ein SharePoint Online-Administrator oder ein globaler Administrator und ein Websitesammlungsadministrator der abgefragten Website sein, um das Get-SPOUser-Cmdlet ausführen zu können.

Angaben zu Berechtigungen sowie die aktuellsten Informationen zu Windows PowerShell für SharePoint Online finden Sie in der Onlinedokumentation unter https://go.microsoft.com/fwlink/p/?LinkId=251832.

Beispiele

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

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance

In Beispiel 1 werden alle Benutzer- oder Sicherheitsgruppenkonten aus der Websitesammlung https://contoso.sharepoint.com/sites/finance zurückgegeben.

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

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -LoginName melissa.kerr@contoso.com

Beispiel 2 gibt ein Benutzer- oder Sicherheitsgruppenkonto mit dem Benutzernamen "melissa.kerr@contoso.com" aus der Websitesammlung https://contoso.sharepoint.com/sites/financezurück.

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

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -Group "Team Site Members"

In Beispiel 3 wird ein Benutzer- oder Sicherheitsgruppenkonto innerhalb der Gruppe „Team Site Members“ aus der Websitesammlung https://contoso.sharepoint.com/sites/finance zurückgegeben.

Parameter

-Group

Gibt die Gruppe an, aus der die Benutzer abgerufen werden sollen.

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

-Limit

Gibt die maximal zurückzugebende Anzahl von Benutzern an. Die Standardeinstellung ist, dass 500 Benutzer zurückgegeben werden. Um alle Benutzer zurückzugeben, müssen Sie den Wert „Alle“ angeben.

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

-LoginName

Gibt den Benutzernamen an.

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

-Site

Gibt die URL der Websitesammlung an, aus der der Benutzer abgerufen werden soll.

Type:SpoSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online