Get-SPOExternalUser
返回租户中的外部用户。
语法
Default （默认值）
Get-SPOExternalUser
[[-Position] <Int32>]
[[-PageSize] <Int32>]
[[-Filter] <String>]
[[-SortOrder] <SortOrder>]
[[-SiteUrl] <String>]
[-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
[<CommonParameters>]
说明
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 匹配的前 30 个 https://contoso.sharepoint.com用户。
参数
-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。