Get-AzADServicePrincipal
サービス プリンシパルからのエンティティを一覧表示するか、キーごとにサービス プリンシパルからエンティティを取得します
構文
EmptyParameterSet (既定)
Get-AzADServicePrincipal
[-Select <String[]>]
[-Count]
[-Filter <String>]
[-Orderby <String[]>]
[-Search <String>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[-CountVariable <String>]
[<CommonParameters>]
ObjectIdParameterSet
Get-AzADServicePrincipal
-ObjectId <String>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
SearchStringParameterSet
Get-AzADServicePrincipal
-DisplayNameBeginsWith <String>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
DisplayNameParameterSet
Get-AzADServicePrincipal
-DisplayName <String>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
ApplicationIdParameterSet
Get-AzADServicePrincipal
-ApplicationId <Guid>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
ApplicationObjectParameterSet
Get-AzADServicePrincipal
-ApplicationObject <IMicrosoftGraphApplication>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
SPNParameterSet
Get-AzADServicePrincipal
-ServicePrincipalName <String>
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
説明
サービス プリンシパルからのエンティティを一覧表示するか、キーごとにサービス プリンシパルからエンティティを取得します
例
例 1: 表示名でサービス プリンシパルを取得する
Get-AzADServicePrincipal -DisplayName $name
表示名でサービス プリンシパルを取得する
例 2: サービス プリンシパルの表示名を検索する
Get-AzADServicePrincipal -DisplayNameStartsWith $prefix
サービス プリンシパルの表示名を検索する
例 3: サービス プリンシパルを一覧表示する
Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected
既定のプロパティ 'DisplayName'、'Id'、'DeletedDateTime'、'ServicePrincipalNames'、'AppId' の後に、最初の 10 個のサービス プリンシパルと追加プロパティ 'Tags' を一覧表示します
例 4: アプリケーション ID でサービス プリンシパルを取得する
Get-AzADServicePrincipal -ApplicationId $appId
アプリケーション ID でサービス プリンシパルを取得する
例 5: パイプライン入力でサービス プリンシパルを取得する
Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal
パイプライン入力によるサービス プリンシパルの取得
例 6: フィルターを使用してサービス プリンシパルを取得する
Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"
フィルターを使用してサービス プリンシパルを取得する
例 7: 変数に OdataCount を割り当てる
Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result
OdataCount を変数に割り当てる
パラメーター
-AppendSelected
このスイッチがオンのときに既定のプロパティで選択された追加プロパティは、パラメーター '-Select' でのみ機能します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ApplicationId
serviceprincipal のアプリケーション ID
パラメーターのプロパティ
型: | Guid
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | AppId |
パラメーター セット
ApplicationIdParameterSet
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ApplicationObject
サービス プリンシパル オブジェクトは、パイプライン入力として使用できます。
パラメーターのプロパティ
パラメーター セット
ApplicationObjectParameterSet
配置: | Named |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConsistencyLevel
要求された整合性レベルを示します。
ドキュメント URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
EmptyParameterSet
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Count
項目の数を含める
パラメーターのプロパティ
パラメーター セット
EmptyParameterSet
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-CountVariable
コレクション内の項目の合計数のカウントを指定します。
既定では、この変数はグローバル スコープで設定されます。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
EmptyParameterSet
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
型: | PSObject
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DisplayName
serviceprincipal の表示名
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
DisplayNameParameterSet
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DisplayNameBeginsWith
serviceprincipal の表示名は次で始まります
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | DisplayNameStartsWith, SearchString |
パラメーター セット
SearchStringParameterSet
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Filter
プロパティ値で項目をフィルター処理します。フィルター クエリの詳細については、次を参照してください。 https://learn.microsoft.com/en-us/graph/filter-query-parameter
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
EmptyParameterSet
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-First
最初の 'n' オブジェクトのみを取得します。
パラメーターのプロパティ
型: | UInt64
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ObjectId
key: servicePrincipal の ID
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ServicePrincipalId, ID (アイディー) |
パラメーター セット
ObjectIdParameterSet
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Orderby
プロパティ値によるアイテムの並べ替え
パラメーターのプロパティ
型: | String[]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
EmptyParameterSet
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Search
検索語句でアイテムを検索する
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
EmptyParameterSet
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Select
返されるプロパティを選択する
パラメーターのプロパティ
型: | String[]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ServicePrincipalName
serviceprincipal 名
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | SPN |
パラメーター セット
SPNParameterSet
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Skip
最初の 'n' オブジェクトを無視し、残りのオブジェクトを取得します。
パラメーターのプロパティ
型: | UInt64
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力