次の方法で共有

Get-MsolServicePrincipal

  • リファレンス
モジュール:
MSOnline

Azure Active Directory からサービス プリンシパルを取得します。

構文

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

説明

Get-MsolServicePrincipal コマンドレットは、Azure Active Directory からサービス プリンシパルまたはサービス プリンシパルの一覧を取得します。

例

例 1: すべてのサービス プリンシパルを表示する

PS C:\> Get-MsolServicePrincipal

このコマンドは、組織のテナント内のすべての既存のサービス プリンシパルを表示します。

例 2: 名前を使用してサービス プリンシパルを取得する

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

このコマンドは、MyApp で始まるサービス プリンシパル名を持つ既存のすべてのサービス プリンシパルを取得します。 これは、サービス プリンシパル名の appClass 部分とスラッシュとの完全一致です。

例 3: サービス プリンシパルを取得する

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

このコマンドは、特定のアプリケーション プリンシパル ID を持つサービス プリンシパルを取得します。

パラメーター

-All

このコマンドレットによってすべての結果が返されることを示します。 MaxResults パラメーターと共にを指定しないでください。

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

-AppPrincipalId

取得するサービス プリンシパルの一意のアプリケーション ID を指定します。

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

-MaxResults

このコマンドレットが返す結果の最大数を指定します。 既定値は 500 です。

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

-ObjectId

取得するサービス プリンシパルの一意のオブジェクト ID を指定します。

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

-SearchString

サービス プリンシパル名と一致する文字列を指定します。

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

-ServicePrincipalName

取得するサービス プリンシパルまたはサービス プリンシパルの名前を指定します。 SPN では、次のいずれかの形式を使用する必要があります。

  • appName
  • appName/hostname
  • 有効な URL

AppName はアプリケーションの名前を表し、ホスト名はアプリケーションの URI 機関を表します。

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

-TenantId

操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。

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

出力

Microsoft.Online.Administration.ServicePrincipal[]

このコマンドレットは、Azure Active Directory からサービス プリンシパルまたはサービス プリンシパルの一覧を返します。 各サービス プリンシパルには次の情報が含まれています。

  • Objectid。 サービス プリンシパルの一意識別子。
  • AppPrincipalId。 サービス プリンシパルのアプリケーション識別子。
  • DisplayName。 サービス プリンシパルのフレンドリ名。
  • ServicePrincipalName。 サービス プリンシパルに関連付けられているサービス プリンシパル名 (SPN) の一覧。
  • AccountEnabled。 アカウントが有効かどうかを示す値。