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 權限和最新資訊，請參閱位於 SharePoint Online Management Shell 簡介的線上文件。
範例
範例 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。