Microsoft Graph PowerShell SDK Preview

PowerShell 向けの Microsoft Graph のモジュールがプレビュー提供されています。PowerShell から Microsoft Graph を使用するためのラッパーのようなモジュールになっています。以前は PowerShell Gallery にも登録されていない状態でしたが、現時点では PowerShell Gallery に登録されたので、比較的容易に試すことができるようになりました。 とはいえまっだプレビュー版なので、利用は自己責任でとなります。利用する Microsoft Graph のエンドポイントも /beta になっています。サポートも受け...

NO IMAGE

Windows PowerShell で MSAL を使って EWS 用のアクセス トークンを取得する

C# で MSAL (Microsoft.Identity.Client) を使って EWS 用のアクセス トークンを取得する方法は Authenticate an EWS application by using OAuth に記載されています。しかしながら PowerShell の場合については Docs に記載がありません。こちらのブログでは PowerShell の場合についての記載がありますが、ADAL も MSAL も使用しない実装になっています。「ライブラリを使用しなくても実装できることをわざわざライブラリを使用して実装するのは面倒」と考えることもできますが、ブログに記載の方法...

Microsoft Graph Toolkit の試し方

Web アプリケーションで Microsoft Graph を使用しやすいように Microsoft Graph Toolkit としていくつかのコンポーネントが用意されています。簡単に使い方を紹介します。 まずは Overview のページに記載の内容を実践しつつ、MSAL provider と Login component を使います。 Visual Studio Code の準備 ここではコード エディターとして Visual Studio Code を使います。ローカルでのデバッグ用に拡張機能の Live Server を使うので、Live Server をイン...

NO IMAGE

RobustCloudCommand Module の紹介

以前は Script だった Start-RobustCloudCommand.ps1 が、Module になってしかも MFA にも対応したということで、使い方を紹介します。 おさらい Exchange Online の PowerShell はスロットリングやセッションの不安定さなどの問題から、長時間大量のオブジェクトに対する処理を実行するのがものすごく苦手です。そんな時にセッションを管理しながら Exchange Online のコマンドを実行するのが Start-RobustCloudCommand.ps1 でした。紹介ブログが日本語にも翻訳されていたので、 Start-...

Microsoft Graph で MAPI プロパティを取得する

Microsoft Graph で標準的に取得できるアイテムのプロパティは、Microsoft Graph で用意されているものだけです。例えばメールを表す message では以下のページにプロパティが書いてあります。 message resource type この一覧にない情報であっても、拡張プロパティとして取得することが可能です。Property Set によって取得方法が少し異なるので、例としてメッセージ クラスの取得の仕方と CleanGlobalObjectId の取得の仕方を紹介します。 メッセージ クラス IPM.Note のような、アイテムのメッセ...

NO IMAGE

Microsoft Graph の getSchedule

Microsoft Graph の getSchedule は、空き時間情報を取得する API です。Outlook のスケジュール アシスタントのように、他人の予定の詳細ではなく空いているかどうかを取得します。基本的なことは Get free/busy schedule of users and resources や calendar: getSchedule を参照してください。 空き時間情報にも何段階かあります。どこまでの情報が取得できるのかは、参照先ユーザーの予定表に対してどこまでの権限を持っているのかによって異なります。いくつかのパターンで見ていきましょう。 まずはテ...

NO IMAGE

Exchange Online の全ユーザーのメールボックスを取得する

Exchange Online では、以下のような全ユーザーを取得するコマンドが失敗するという話をよく聞きます。 Get-Mailbox -ResultSize Unlimited これは割と有名な話で、特に大規模な環境でユーザー数が多いと失敗します。データ量が多くなることが問題の 1 つなので、対策としては、例えば以下のブログでは Invoke-Command を使ってサーバー サイドで実行して結果だけを受け取る方法を紹介しています。 膨大な数の Office 365 ユーザーへの PowerShell コマンドレットの実行 Invoke-Command -sess...

NO IMAGE

Office 365 の監査ログを全部取得したい?

本当に監査ログを取得する必要があるのか Office 365 の監査ログを長期に渡って保存する必要があり全部取得したいという話を時々聞きます。そんな時は、一度冷静に考える必要があります。 なぜ 3 か月 (もしくは 1 年) 以上保存する必要があるのか 監査ログを取得しなかったら何が起きるのか 取得したとして、どうやって保存するのか 保存した監査ログをどうやって検索するのか 根本的に、Office 365 の監査ログの保存期間は原則 3 か月です。Office 365 E5 / Microsoft 365 E5 / Microsoft 365 E5 Complianc...

NO IMAGE

Office 365 Management Activity API の試し方

Office 365 Management Activity API を簡単に試す方法はありませんが、Office365APIEditor を使用することで比較的簡単に動作を確認できます。紹介するのは Exchange 関連の監査ログの取得方法のみですが、同じ要領で他の監査ログも取得できます。Office365APIEditor の通信を Fiddler で取得すれば、どのような通信が行われているのか確認することができます。実際に Office 365 Management Activity API を使用するアプリケーションを開発する場合は、これらの通信を実装することになります。なお前提と...

NO IMAGE

Office 365 Reporting Web サービスの試し方

Office 365 Reporting Web Service を簡単に試す方法はありませんが、PowerShell を使用することで比較的簡単に動作を確認できます。紹介するのはメッセージ追跡ログの取得方法のみですが、同じ要領で他のレポートも取得できます。 PowerShell で試す Windows PowerShell を起動します。以下のようにコマンドを実行します。認証ダイアログが表示されたら Office 365 の管理者の資格情報を入力してください。ここでは検索条件として差出人のメール アドレスを指定しているので、適宜変更してください。 $Credential ...