【 Get-MgServicePrincipal 】コマンドレット――Microsoft Entra ID（旧Azure AD）に登録されたサービスプリンシパルの情報を参照する：Windows PowerShell基本Tips（101）

本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「Get-MgServicePrincipal」コマンドレットを解説します。

[国井傑，株式会社エストディアン]

連載目次

　本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は「Microsoft Entra ID」（旧称：Microsoft Azure Active Directory《Azure AD》）に登録された「サービスプリンシパル」の情報を参照する「Get-MgServicePrincipal」コマンドレットです。

目次

Get-MgServicePrincipalの概要 | 書式 | オプション

実行例

• 全てのサービスプリンシパルを表示する
• AppId（アプリケーション名）を表示する
• 特定の名前を持つサービスプリンシパルだけを表示する

Get-MgServicePrincipalコマンドレットとは？

　「Get-MgServicePrincipal」は、PowerShellを利用してMicrosoft Entra IDに登録されたサービスプリンシパルの情報を参照するためのコマンドレットです。サービスプリンシパルはアプリケーションが認証に使うIDで、サービスプリンシパルとして登録されたアプリケーションは「条件付きアクセス」によるアクセス制御を実施できます。

　通常、Microsoft Entra IDの「エンタープライズアプリケーション」に登録されたアプリケーションがサービスプリンシパルとして登録されます。しかし、「Microsoft Office 365」ように、明示的にエンタープライズアプリケーションに登録する必要のないアプリケーションでもサービスプリンシパルとして自動的に登録されている場合があります。

　このように、エンタープライズアプリケーションとサービスプリンシパルは必ずしも同じアプリケーションが登録されているわけでありません。そのため、サービスプリンシパルの一覧を参照する必要がある場合は、本連載第87回で解説したエンタープライズアプリケーションの一覧を参照する「Get-MgApplication」コマンドレットではなく、今回紹介するGet-MgServicePrincipalコマンドレットを利用します。

　なお、Get-MgServicePrincipalコマンドレットは、本連載第45回で解説した「Connect-MgGraph」コマンドレットで「Connect-MgGraph -Scopes "Application.Read.All"」と実行して、Microsoft Entra IDへの接続とアクセス許可を与えておくことが前提条件になります。

Get-MgServicePrincipalコマンドレットの書式

Get-MgServicePrincipal [オプション]

Get-MgServicePrincipalコマンドレットの主なオプション

オプション	意味
-All	全てのサービスプリンシパルを表示する。省略可能
-Property	特定のプロパティ（属性）を表示する。省略可能
-ConsistencyLevel	ConsistencyLevelヘッダを定義し、Advanced Queryを有効化する。省略可能
-Count	Get-MgServicePrincipalコマンドレットが返した値を変数として設定する。省略可能
-Filter	条件に合致するサービスプリンシパルを表示する。省略可能

目次に戻る

全てのサービスプリンシパルを表示する

　Get-MgServicePrincipalコマンドレットをオプションなしでそのまま実行した場合は、最大で100個のサービスプリンシパルまでしか表示しません。Microsoft Entra IDに登録されている全てのサービスプリンシパルを表示させる場合は、「-All」オプションを付けて実行します（画面1）。