Get-EntraServicePrincipalOwnedObject
サービス プリンシパルが所有するオブジェクトを取得します。
構文
Default (既定)
Get-EntraServicePrincipalOwnedObject
-ServicePrincipalId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
説明
Get-EntraServicePrincipalOwnedObject コマンドレットは、Microsoft Entra IDのサービス プリンシパルが所有するオブジェクトを取得します。
例
例 1: サービス プリンシパルの所有オブジェクトを取得する
Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Get-EntraServicePrincipalOwnedObject -ServicePrincipalId $servicePrincipal.Id | Select-Object Id, DisplayName, '@odata.type'
Id displayName @odata.type
-- ----------- -----------
cccccccc-2222-3333-4444-dddddddddddd Contoso Application #microsoft.graph.servicePrincipal
このコマンドは、サービス プリンシパルの所有オブジェクトを取得します。
-
-ServicePrincipalIdパラメーターは、サービス プリンシパルの ID を指定します。
例 2: サービス プリンシパルのすべての所有オブジェクトを取得する
Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Get-EntraServicePrincipalOwnedObject -ServicePrincipalId $servicePrincipal.Id -All | Select-Object Id, DisplayName, '@odata.type'
Id displayName @odata.type
-- ----------- -----------
cccccccc-2222-3333-4444-dddddddddddd Contoso Application #microsoft.graph.servicePrincipal
次の使用例は、Microsoft Entra IDのサービス プリンシパルが所有するオブジェクトを取得します。 コマンド Get-EntraServicePrincipal を使用して、サービス プリンシパル ID を取得できます。
-
-ServicePrincipalIdパラメーターは、サービス プリンシパルの ID を指定します。
例 3: サービス プリンシパルの所有オブジェクトの上位 1 つを取得する
Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Get-EntraServicePrincipalOwnedObject -ServicePrincipalId $servicePrincipal.Id -Top 1 | Select-Object Id, DisplayName, '@odata.type'
Id displayName @odata.type
-- ----------- -----------
cccccccc-2222-3333-4444-dddddddddddd Contoso Application #microsoft.graph.servicePrincipal
次の使用例は、Microsoft Entra IDで指定したサービス プリンシパルの所有オブジェクトの上位 1 つを取得します。
-Limitのエイリアスとして-Topを使用できます。
-
-ServicePrincipalIdパラメーターは、サービス プリンシパルの ID を指定します。
パラメーター
-All
すべてのページを一覧表示します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Property
返されるプロパティを指定します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Select |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ServicePrincipalId
Microsoft Entra IDのサービス プリンシパルの ID を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | オブジェクト識別子 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Top
返されるレコードの最大数を指定します。
パラメーターのプロパティ
| 型: | System.Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 極限 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
メモ
コマンド Add-EntraServicePrincipalOwner を使用して、サービス プリンシパルに所有者を追加できます。