Get-SPOExternalUser

  • リファレンス
モジュール:
Microsoft.Online.SharePoint.PowerShell
適用対象:
SharePoint Online

テナント内の外部ユーザーを返します。

構文

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