次の方法で共有


より多くの Microsoft Graph API でアプリのみの認証を使用する PowerShell スクリプトを拡張する

この記事では、「Microsoft Graph を使用した PowerShell スクリプトのビルド」で作成したアプリケーションに独自 の Microsoft Graph 機能を追加します。 たとえば、Microsoft Graph ドキュメントGraph エクスプローラー、または作成したコードからコード スニペットを追加できます。

API を選択する

試したい API を Microsoft Graph で見つけます。 たとえば、 List グループ API などです。 API ドキュメントのいずれかの例を使用するか、Graph エクスプローラーで API 要求をカスタマイズし、生成されたスニペットを使用するか、Find-MgGraphCommand コマンドを使用して対応するコマンドを見つけることができます。

たとえば、グループを一覧表示する API エンドポイントは GET /groups。 この情報を使用して、対応する PowerShell コマンドを見つけることができます。

PS > Find-MgGraphCommand -Uri "/groups" -Method "GET"

   APIVersion: v1.0

Command     Module Method URI     OutputType           Permissions
-------     ------ ------ ---     ----------           -----------
Get-MgGroup Groups GET    /groups IMicrosoftGraphGroup {Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, G…

   APIVersion: beta

Command     Module Method URI     OutputType            Permissions
-------     ------ ------ ---     ----------            -----------
Get-MgGroup Groups GET    /groups IMicrosoftGraphGroup1 {Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, …

出力は、 Get-MgGroup コマンドが対応するコマンドであることを示します。

アクセス許可を構成する

選択した API のリファレンス ドキュメントの [アクセス許可] セクションを確認して、サポートされている認証方法を確認します。 たとえば、一部の API ではアプリ専用がサポートされていません。

アプリ専用認証を使用して API を呼び出すには (API でサポートされている場合)、Microsoft Entra 管理センターに必要なアクセス許可スコープを追加します。 必ず、アプリのみのアクセス許可を使用して切断して再接続してください。

ヒント

Connect-MgGraph コマンドで -ForceRefresh パラメーターを使用すると、新しく構成されたアクセス許可が確実に適用されます。

コマンドを実行する

必要なアクセス許可に接続したら、選択したコマンドを実行します。

Microsoft Graph を呼び出す作業アプリが作成されたので、新しい機能を試して追加できます。