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 |