Get-SPOExternalUser
傳回租使用者中的外部使用者。
語法
Default (預設值)
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
適用：SharePoint Online
將結果限製為只有名字、姓氏或電子郵件地址開頭為字串中使用不區分大小寫比較之文字的使用者。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 4 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PageSize
適用：SharePoint Online
指定要傳回集合中的使用者數上限。
此值必須小於或等於 50。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Position
適用：SharePoint Online
使用此參數可指定第一個傳回結果在排序後之集合內的位置索引 (從零開始)。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount
適用：SharePoint Online
顯示已接受邀請但未使用已傳送邀請之帳戶的使用者。
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SiteUrl
適用：SharePoint Online
指定要擷取其外部使用者的網站。
若未指定網站，則會傳回所有網站的外部使用者。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 6 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SortOrder
適用：SharePoint Online
指定結果應依照 SPOUser.Email 屬性的遞增或遞減順序排列。
參數屬性
| 類型: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 5 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。