Get-AzureRmADServicePrincipal

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

Active Directory サービス プリンシパルをフィルター処理します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

説明

Active Directory サービス プリンシパルをフィルター処理します。

例

例 1 - AD サービス プリンシパルを一覧表示する

PS C:\> Get-AzureRmADServicePrincipal

テナント内のすべての AD サービス プリンシパルを一覧表示します。

例 2 - ページングを使用して AD サービス プリンシパルを一覧表示する

PS C:\> Get-AzureRmADServicePrincipal -First 100

テナント内の最初の 100 個の AD サービス プリンシパルを一覧表示します。

例 3 - SPN 別にサービス プリンシパルを一覧表示する

PS C:\> Get-AzureRmADServicePrincipal -ServicePrincipalName 36f81fc3-b00f-48cd-8218-3879f51ff39f

SPN '36f81fc3-b00f-48cd-8218-3879f51ff39f' のサービス プリンシパルを一覧表示します。

例 4 - 検索文字列でサービス プリンシパルを一覧表示する

PS C:\> Get-AzureRmADServicePrincipal -SearchString "Web"

表示名が "Web" で始まるすべての AD サービス プリンシパルを一覧表示します。

例 5 - 配管でサービス プリンシパルを一覧表示する

PS C:\> Get-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

オブジェクト ID '39e64ec6-569b-4030-8e1c-c3c519a05d69' を持つ AD アプリケーションを取得し、それを Get-AzureRmADServicePrincipal コマンドレットにパイプして、そのアプリケーションのすべてのサービス プリンシパルを一覧表示します。

パラメーター

-ApplicationId

サービス プリンシパル アプリケーション ID。

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

-ApplicationObject

サービス プリンシパルを取得するアプリケーション オブジェクト。

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

-DefaultProfile

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

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

-DisplayName

サービス プリンシパルの表示名。

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

-DisplayNameBeginsWith

サービス プリンシパルの検索文字列。

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

-First

返されるオブジェクトの最大数。

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

-IncludeTotalCount

データ セット内のオブジェクトの数を報告します。 現時点では、このパラメーターは何も行いません。

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

-ObjectId

サービス プリンシパルのオブジェクト ID。

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

-ServicePrincipalName

サービスの SPN。

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

-Skip

最初の N 個のオブジェクトを無視し、再メインオブジェクトを取得します。

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

入力

String

Guid

PSADApplication

パラメーター: ApplicationObject (ByValue)

出力

PSADServicePrincipal