Freigeben über


Get-SPOExternalUser

Gibt externe Benutzer im Mandanten zurück.

Syntax

Default (Standardwert)

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

Anwendbar: SharePoint Online

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.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PageSize

Anwendbar: SharePoint Online

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

Der Wert muss kleiner oder gleich 50 sein.

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Position

Anwendbar: SharePoint Online

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

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount

Anwendbar: SharePoint Online

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

Parametereigenschaften

Typ:System.Boolean
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

-SiteUrl

Anwendbar: SharePoint Online

Gibt die Website zum Abrufen von externen Benutzern an.

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

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:6
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SortOrder

Anwendbar: SharePoint Online

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

Parametereigenschaften

Typ:Microsoft.Online.SharePoint.TenantManagement.SortOrder
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:5
Obligatorisch.:False
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.