Get-SPOExternalUser

  • 参考
模块:
Microsoft.Online.SharePoint.PowerShell
适用于:
SharePoint Online

返回租户中的外部用户。

语法

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