Get-SPOUser
Gibt die SharePoint Online-Benutzer- oder -Sicherheitsgruppenkonten zurück, die einem bestimmten Suchkriterium entsprechen.
Syntax
All (Standardwert)
Get-SPOUser
-Site <SpoSitePipeBind>
[-Limit <String>]
[<CommonParameters>]
ByGroup
Get-SPOUser
-Site <SpoSitePipeBind>
[-Group <String>]
[-Limit <String>]
[<CommonParameters>]
ByLogin
Get-SPOUser
-Site <SpoSitePipeBind>
[-LoginName <String>]
[<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.
Stellen Sie sicher, dass Sie das Get-SPOUser Cmdlet mindestens als SharePoint Online-Administrator ausführen und ein Websitesammlungsadministrator der abgefragten Website sein.
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
Anwendbar: SharePoint Online
Gibt die Gruppe an, aus der die Benutzer abgerufen werden sollen.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByGroup
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Limit
Anwendbar: SharePoint Online
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.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
All
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ByGroup
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LoginName
Anwendbar: SharePoint Online
Gibt den Benutzernamen an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByLogin
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Site
Anwendbar: SharePoint Online
Gibt die URL der Websitesammlung an, aus der der Benutzer abgerufen werden soll.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.