次の方法で共有

追加の Microsoft Graph API を使用して PowerShell スクリプトを拡張する

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

API を選択する

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

たとえば、イベントを作成する API エンドポイントの 1 つが POST /users/{id | userPrincipalName}/events。 これを使用して、対応する PowerShell コマンドを見つけることができます。

PS > Find-MgGraphCommand -Uri "/users/{id | userPrincipalName}/events" -Method "POST"

   APIVersion: v1.0

Command         Module   Method URI                     OutputType           Permissions           Variants
-------         ------   ------ ---                     ----------           -----------           --------
New-MgUserEvent Calendar POST   /users/{user-id}/events IMicrosoftGraphEvent {Calendars.ReadWrite} {Create1, CreateExp…

   APIVersion: beta

Command         Module   Method URI                     OutputType            Permissions           Variants
-------         ------   ------ ---                     ----------            -----------           --------
New-MgUserEvent Calendar POST   /users/{user-id}/events IMicrosoftGraphEvent1 {Calendars.ReadWrite} {Create, CreateExp…

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

アクセス許可を構成する

選択した API のリファレンス ドキュメントの [アクセス許可] セクションを確認して、サポートされている認証方法を確認します。 たとえば、一部の API では、ユーザー (委任された) 認証や個人の Microsoft アカウントがサポートされていません。

現在のセッション (Disconnect-MgGraph) を切断し、 -Scopes パラメーターで必要なアクセス許可に再接続します。

ヒント

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

コマンドを実行する

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

関連コンテンツ

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

  • Microsoft Graph PowerShell SDK で アプリのみの認証 を使用する方法について説明します。
  • Microsoft Graph でアクセスできるすべてのデータについては、 Microsoft Graph の概要 に関するページを参照してください。
  • Last updated on