Get-SPOExternalUser
返回租户中的外部用户。
语法
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
使用不区分大小写的比较，将结果限制为其名字、姓氏或电子邮件地址以字符串中的文本开头的用户。
| 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 |