次の方法で共有

Get-AzADServicePrincipal

  • リファレンス
モジュール:
Az.Resources

サービス プリンシパルからのエンティティを一覧表示するか、キーごとにサービス プリンシパルからエンティティを取得します

構文

Get-AzADServicePrincipal
   [-Select <String[]>]
   [-Count]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -ObjectId <String>
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayNameBeginsWith <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationId <Guid>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationObject <IMicrosoftGraphApplication>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   [-Select <String[]>]
   -ServicePrincipalName <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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ApplicationId

serviceprincipal のアプリケーション ID

型:Guid
Aliases:AppId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ApplicationObject

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

型:IMicrosoftGraphApplication
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ConsistencyLevel

要求された整合性レベルを示します。 ドキュメント URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Count

項目の数を含める

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CountVariable

コレクション内の項目の合計数のカウントを指定します。 既定では、この変数はグローバル スコープで設定されます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:PSObject
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisplayName

serviceprincipal の表示名

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisplayNameBeginsWith

serviceprincipal の表示名は次で始まります

型:String
Aliases:DisplayNameStartsWith, SearchString
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Filter

プロパティ値で項目をフィルター処理します。フィルター クエリの詳細については、次を参照してください: https://zcusa.951200.xyz/en-us/graph/filter-query-parameter

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-First

最初の 'n' オブジェクトのみを取得します。

型:UInt64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ObjectId

key: servicePrincipal の ID

型:String
Aliases:ServicePrincipalId, Id
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Orderby

プロパティ値によるアイテムの並べ替え

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Search

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Select

返されるプロパティを選択する

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicePrincipalName

serviceprincipal 名

型:String
Aliases:SPN
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Skip

最初の 'n' オブジェクトを無視し、残りのオブジェクトを取得します。

型:UInt64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

IMicrosoftGraphApplication

出力

IMicrosoftGraphServicePrincipal