Get-SPOExternalUser
Returns external users in the tenant.
構文
Default (既定)
Get-SPOExternalUser
[[-Position] <Int32>]
[[-PageSize] <Int32>]
[[-Filter] <String>]
[[-SortOrder] <SortOrder>]
[[-SiteUrl] <String>]
[-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
[<CommonParameters>]
説明
The Get-SPOExternalUser cmdlet returns external users that are located in the tenant based on specified criteria.
For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at https://go.microsoft.com/fwlink/p/?LinkId=251832.
例
EXAMPLE 1
Get-SPOExternalUser -Position 0 -PageSize 2
Example 1 returns the first two external users in the collection.
EXAMPLE 2
Get-SPOExternalUser -Position 2 -PageSize 2
Example 2 returns two external users from the third page of the collection.
EXAMPLE 3
Get-SPOExternalUser -Position 0 -PageSize 30 -SiteUrl https://contoso.sharepoint.com
Example 3 returns the first 30 users that match the SiteUrl https://contoso.sharepoint.com.
パラメーター
-Filter
Applicable: SharePoint Online
Limits the results to only those users whose first name, last name, or email address begins with the text in the string using a case-insensitive comparison.
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PageSize
Applicable: SharePoint Online
Specifies the maximum number of users to be returned in the collection.
The value must be less than or equal to 50.
パラメーターのプロパティ
| 型: | System.Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Position
Applicable: SharePoint Online
Use to specify the zero-based index of the position in the sorted collection of the first result to be returned.
パラメーターのプロパティ
| 型: | System.Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount
Applicable: SharePoint Online
Shows users who have accepted an invite but not using the account the invite was sent to.
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SiteUrl
Applicable: SharePoint Online
Specifies the site to retrieve external users for.
If no site is specified, the external users for all sites are returned.
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 6 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SortOrder
Applicable: SharePoint Online
Specifies the sort results in Ascending or Descending order on the SPOUser.Email property should occur.
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 5 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.