Get-SPOExternalUser

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

Gibt externe Benutzer im Mandanten zurück.

Syntax

Get-SPOExternalUser
   [[-Position] <Int32>]
   [[-PageSize] <Int32>]
   [[-Filter] <String>]
   [[-SortOrder] <SortOrder>]
   [[-SiteUrl] <String>]
   [-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
   [<CommonParameters>]

Beschreibung

Das Get-SPOExternalUser Cmdlet gibt externe Benutzer zurück, die sich im Mandanten befinden, basierend auf angegebenen Kriterien.

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-SPOExternalUser -Position 0 -PageSize 2

Im ersten Beispiel werden die beiden ersten externen Benutzer aus der Auflistung zurückgegeben.

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

Get-SPOExternalUser -Position 2 -PageSize 2

Im zweiten Beispiel werden zwei externe Benutzer der dritten Seite der Auflistung zurückgegeben.

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

Get-SPOExternalUser -Position 0 -PageSize 30 -SiteUrl https://contoso.sharepoint.com

Beispiel 3 gibt die ersten 30 Benutzer zurück, die mit siteUrl https://contoso.sharepoint.comübereinstimmen.

Parameter

-Filter

Beschränkt die Ergebnisse auf die Benutzer, deren Vorname, Nachname oder E-Mail-Adresse mit dem Text in der Zeichenfolge beginnt, wobei die Groß-/Kleinschreibung nicht beachtet wird.

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

-PageSize

Gibt die maximale Anzahl der aus der Auflistung zurückzugebenden Benutzer an.

Der Wert muss kleiner oder gleich 50 sein.

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

-Position

Gibt den nullbasierten Index der Position des ersten zurückzugebenden Ergebnisses in der sortierten Auflistung an.

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

-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount

Zeigt Benutzer an, die eine Einladung angenommen haben, aber nicht das Konto verwenden, an das die Einladung gesendet wurde.

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

-SiteUrl

Gibt die Website zum Abrufen von externen Benutzern an.

Wenn keine Website angegeben ist, werden die externen Benutzer aller Websites zurückgegeben.

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

-SortOrder

Gibt die Sortierergebnisse in aufsteigender oder absteigender Reihenfolge gemäß der SPOUser.Email-Eigenschaft an.

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