Get-EntraUserSponsor
ユーザーのスポンサー (ユーザーまたはグループ) を取得します。
構文
GetQuery
Get-EntraUserSponsor
-UserId <String>
[-All]
[-Filter <String>]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraUserSponsor
-UserId <String>
-SponsorId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
説明
Get-EntraUserSponsor コマンドレットは、ユーザーのスポンサー (ユーザーまたはグループ) を取得します。 スポンサー機能は、ユーザーまたはグループを割り当てて説明責任を確保することで、各ゲスト ユーザーの責任者を追跡します。
職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーには、サポートされているMicrosoft Entraロールまたはmicrosoft.directory/users/sponsors/read permissionを持つカスタム ロールが必要です。 サポートされている最小限の特権ロールは次のとおりです。
- ゲスト招待者
- ディレクトリの読み手
- ディレクトリ製作者
- ユーザー管理者
例
例 1: ユーザー スポンサーを取得する
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -All |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
eeeeeeee-4444-5555-6666-ffffffffffff Fabrikam Helpdesk Group #microsoft.graph.group 8/7/2024 2:52:47 PM
この例では、ユーザー スポンサーを一覧表示する方法を示します。
-
-UserIdパラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。
例 2: 上位 1 人のスポンサーを取得する
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -Top 1 |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
次の使用例は、指定したユーザーのトップ スポンサーを取得します。
-Limitのエイリアスとして-Topを使用できます。
-
-UserIdパラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。
例 3: 特定のユーザーに割り当てられたスポンサーを SponsorId で取得する
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -SponsorId 'cccccccc-2222-3333-4444-dddddddddddd' |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
eeeeeeee-4444-5555-6666-ffffffffffff Fabrikam Helpdesk Group #microsoft.graph.group 8/7/2024 2:52:47 PM
次の使用例は、指定したユーザーに割り当てられたスポンサーを取得します。
-
-UserIdパラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。 -
-SponsorIdパラメーターは、取得する特定のユーザーのスポンサー ID (ユーザーまたはグループ ID) を指定します。
パラメーター
-All
すべてのページを一覧表示します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Filter
OData v4.0 フィルター ステートメントを指定します。 このパラメーターは、返されるオブジェクトを制御します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
GetQuery
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Property
返されるプロパティを指定します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Select |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SponsorId
取得する特定のユーザーのスポンサー ID (ユーザーまたはグループ ID) を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Top
返されるレコードの最大数を指定します。
パラメーターのプロパティ
| 型: | System.Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 極限 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-UserId
Microsoft Entra IDのユーザーの ID (UserPrincipalName または UserId) を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。