Get-SPOExternalUser
テナント内の外部ユーザーを返します。
構文
Get-SPOExternalUser
[[-Position] <Int32>]
[[-PageSize] <Int32>]
[[-Filter] <String>]
[[-SortOrder] <SortOrder>]
[[-SiteUrl] <String>]
[-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
[<CommonParameters>] 説明
コマンドレットは Get-SPOExternalUser 、指定した条件に基づいてテナント内にある外部ユーザーを返します。
SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、https://go.microsoft.com/fwlink/p/?LinkId=251832 のオンライン ドキュメントを参照してください。
例
-----------------------例 1-----------------------------
Get-SPOExternalUser -Position 0 -PageSize 2例 1 では、コレクション内の最初の 2 人の外部ユーザーを取得します。
-----------------------例 2-----------------------------
Get-SPOExternalUser -Position 2 -PageSize 2例 2 では、コレクションの 3 番目のページから 2 人の外部ユーザーを取得します。
-----------------------例 3-----------------------------
Get-SPOExternalUser -Position 0 -PageSize 30 -SiteUrl https://contoso.sharepoint.com例 3 は、SiteUrl https://contoso.sharepoint.comに一致する最初の 30 人のユーザーを返します。
パラメーター
-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 |