次の方法で共有


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' でのみ機能します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ApplicationId

serviceprincipal のアプリケーション ID

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AppId

パラメーター セット

ApplicationIdParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ApplicationObject

サービス プリンシパル オブジェクトは、パイプライン入力として使用できます。

パラメーターのプロパティ

型:IMicrosoftGraphApplication
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

項目の数を含める

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

検索語句でアイテムを検索する

パラメーターのプロパティ

型: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を参照してください。

入力

IMicrosoftGraphApplication

出力

IMicrosoftGraphServicePrincipal