共用方式為


Get-SPOExternalUser

傳回租使用者中的外部使用者。

Syntax

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

Description

Cmdlet 會 Get-SPOExternalUser 根據指定的準則傳回位於租使用者中的外部使用者。

如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊,請參閱位於https://go.microsoft.com/fwlink/p/?LinkId=251832的線上文件。

範例

-----------------------範例 1-----------------------------

Get-SPOExternalUser -Position 0 -PageSize 2

範例 1 會傳回集合中的前兩名外部使用者。

-----------------------範例 2-----------------------------

Get-SPOExternalUser -Position 2 -PageSize 2

範例 2 會傳回集合第三頁中的兩名外部使用者。

-----------------------範例 3-----------------------------

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

範例 3 會傳回符合 SiteUrl https://contoso.sharepoint.com 的前 30 位使用者。

參數

-Filter

將結果限制為只有名字、姓氏或電子郵件地址開頭為字串中使用不區分大小寫比較之文字的使用者。

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

-PageSize

指定要傳回集合中的使用者數上限。

此值必須小於或等於 50。

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

-Position

使用此參數可指定第一個傳回結果在排序後之集合內的位置索引 (從零開始)。

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

-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount

顯示已接受邀請但未使用已傳送邀請之帳戶的使用者。

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

-SiteUrl

指定要擷取其外部使用者的網站。

若未指定網站,則會傳回所有網站的外部使用者。

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

-SortOrder

指定結果應依照 SPOUser.Email 屬性的遞增或遞減順序排列。

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