Get-SPOUser
指定した検索条件と一致する SharePoint Online ユーザーまたはセキュリティ グループのアカウントを返します。
構文
All (既定)
Get-SPOUser
-Site <SpoSitePipeBind>
[-Limit <String>]
[<CommonParameters>]
ByGroup
Get-SPOUser
-Site <SpoSitePipeBind>
[-Group <String>]
[-Limit <String>]
[<CommonParameters>]
ByLogin
Get-SPOUser
-Site <SpoSitePipeBind>
[-LoginName <String>]
[<CommonParameters>]
説明
このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。
Get-SPOUser コマンドレットでは、1 つのユーザーまたはセキュリティ グループだけが一致します。
少なくとも SharePoint Online 管理者として Get-SPOUser コマンドレットを実行し、クエリ対象サイトのサイト コレクション管理者であることを確認してください。
SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、https://go.microsoft.com/fwlink/p/?LinkId=251832 のオンライン ドキュメントを参照してください。
例
例 1
Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance
例 1 サイト コレクション https://contoso.sharepoint.com/sites/finance からすべてのユーザーまたはセキュリティ グループ アカウントを返します。
例 2
Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -LoginName melissa.kerr@contoso.com
例 2 は、ユーザー名がサイト コレクション https://contoso.sharepoint.com/sites/financeから "melissa.kerr@contoso.com" である 1 つのユーザーまたはセキュリティ グループ アカウントを返します。
例 3
Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -Group "Team Site Members"
例 3 は、サイト コレクション https://contoso.sharepoint.com/sites/finance から Team Site Members グループ内のユーザーまたはセキュリティ グループのアカウントを 1 つ取得します。
パラメーター
-Group
適用対象: SharePoint Online
ユーザーを取得するグループを指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByGroup
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Limit
適用対象: SharePoint Online
取得するユーザーの最大数を指定します。 既定値は、すべてのユーザーを取得します。 すべてのユーザーを取得するには、値「All」を指定してください。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ByGroup
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LoginName
適用対象: SharePoint Online
ユーザー名を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByLogin
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Site
適用対象: SharePoint Online
ユーザーを取得するサイト コレクションの URL を指定します。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。