この記事では、「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 を呼び出す作業アプリが作成されたので、新しい機能を試して追加できます。
- Microsoft Graph PowerShell SDK で ユーザー (委任された) 認証 を使用する方法について説明します。
- Microsoft Graph でアクセスできるすべてのデータについては、 Microsoft Graph の概要 に関するページを参照してください。