グラフの探索 PowerShell SDK

最近、PowerShell で Microsoft グラフを使用して、Microsoft 365 内の一般的な管理タスクを自動化する方法を模索してきました。PowerShell でグラフ API の使用を検討する最近の要因の中には、次のものがあります。

私は使用しました パワーシェル用のマイクロソフトグラフSDK 最初の問題を解決し、ネイティブ Graph API が 2 番目の問題を呼び出します。この記事では、次の代替手段について説明します。 メールメッセージの送信 を使用してコマンドレットを使用して、 新しいMgUserメッセージ そして 送信 – MgUser メッセージ 新しい従業員にウェルカム メッセージを作成して送信するための、SDK からのコマンドレット。

ウェルカムメール

組織は、オンボーディング プロセスの一環として、新しい従業員にウェルカム メールを送信します。電子メールには通常、組織で働くことや、カフェテリアを見つける方法など、新入社員が知っておくべきことに関する役立つヒントが含まれています。この処理を自動化するために、スクリプトは次の処理を実行します。

• Exchange Online に接続して、過去 7 日間に追加された従業員のメールボックスを検索します。
• Microsoft グラフに接続して、電子メールを作成して送信します。グラフへのすべての接続と同様に、データにアクセスするためのアクセス許可が必要です。この場合、我々は必要です 送信 そして メール.読み取り書き込み 権限。スクリプトは対話式に実行されるため、スクリプトは サービス プリンシパルのアクセス許可クリープに注意する グラフに接続するために使用されます。
• 見つかったセット内の各メールボックスに対して、 新しいMgUserメッセージ コマンドレットを使用して、サインインしているユーザーのメールボックスに HTML メッセージを作成します。
• を使用してメッセージを送信します。 送信 – MgUser メッセージ コマンドレット。

スクリプトは基本的なものです(以下のことができます。 GitHub からダウンロードする)が、校長を証明するのに十分である。添付ファイル (新しい従業員ガイドなど) を追加するか、受信者のセットを変更することで、添付ファイルを装飾できます。私たちは後でそれらのポイントに到達します。

接続するコード

グラフに接続するコードは簡単です。

ザ コネクト・Mgグラフ コマンドレットは、テナント識別子を使用してテナントに接続し (テナントに適切な値を使用していることを確認してください)、必要な 2 つのアクセス許可を要求します。Graph SDK で使用されるサービス プリンシパルがこれらのアクセス許可に対する同意をまだ保持していない場合、Graph は同意を求めます。他のコマンドは、ログインコンテキストと組織名の詳細を取得します。

ターゲット メールボックスの検索

ターゲット メールボックスを検索するコードは、過去 7 日間に作成されたメールボックスを検索します。繰り返しますが、それは非常に簡単です:

メッセージの作成と送信

一連のターゲット メールボックスを見つけた後、各メールボックスをループしてカスタマイズされた HTML メッセージを作成し (図 1)、次の手順で必要なメッセージ プロパティのセットを設定します。 送信 – MgUser メッセージ 新しいメッセージを受信者に送信するコマンドレット。