PowerShell 用のマイクロソフトグラフ SDK を使用して Alternate からオンラインで電子メールを送信する

2021年10月19日

[ad_1]

グラフの探索 PowerShell SDK

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

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

ウェルカムメール

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

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

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

接続するコード

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

接続 MgGraph -テナント Id a562313f-14fc-43a2-9a7a-d2e27f4f3478 -スコープ “Mail.Send, Mail.ReadWrite" $Details = 取得-Mg コンテキスト $Scopes = $Details |選択 – 展開プロパティのスコープ $Scopes = $Scopes – 結合 “, " $ProfileName = (取得-Mgプロファイル)。名前 $TenantName = (ゲット・Mg組織)。表示名

繋ぐ–Mgグラフ –テナントID a562313f–14fc–43a2–9a7a–d2e27f4f3478 –スコープ “メール.送信、メール.読み取り書き"

$細部 = 取得–Mg コンテキスト

$スコープ = $細部 | 選ぶ –プロパティを展開します。スコープ

$スコープ = $スコープ –接続 “, “

$プロファイル名 = (取得–Mgプロファイル).名前

$テナント名 = (取得–Mg組織).表示名

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

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

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

[string]$CheckDate = (取得日付)。アディションズ(-7) # 対象期間内に作成されたすべてのメールボックスを検索する [array]$Users = (Get-ExoMailbox -フィルタ “WhenMailboxCreated -gt '$CheckDate’|’メールボックス作成時、表示名、ユーザープリンシパル名、プライマリSmtpアドレスを選択します) ($Users -eq $Null) { 書き込みホスト (“{0}前に作成されたメールボックスが見つかりません。終了中! -f $CheckDate) }

[string]$チェック日付 = (ゲt–日付).追加日(–7)

# 対象期間内に作成されたすべてのメールボックスを検索する

[array]$ユーザー = (取得–エキソメールボックス –フィルター「メールボックス作成時 -gt '$CheckDate’」 –受信者の種類の詳細ユーザーメールボックス –結果サイズ無制限の –プロパティメールボックスが作成された場合 | 選ぶメールボックスが作成された場合, 表示名, ユーザープリンシパル名, プライマリSmtpアドレス)

もし ($ユーザー –eq $ヌル) { 書く–ホスト (“{0}前に作成されたメールボックスが見つかりませんでした。出て行く! –f $チェック日付) }

メッセージの作成と送信

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

PowerShell 用のマイクロソフトグラフ SDK を使用して Exchange からオンラインで電子メールを送信する — 図 1: 新しい従業員のカスタマイズされた HTML メッセージ

# 新しいメールボックスのそれぞれにウェルカム電子メールメッセージを作成して送信する ForEach ($Usersの$User) { # メールボックスのプライマリ SMTP アドレスを使用して受信者を追加する $EmailRecipient = $User.プライマリSmtpアドレス $EmailAddress = @{アドレス = $User.PrimarySmtpAddress} $EmailRecipient = @{電子メールアドレス = $EmailAddress} 書き込みホスト「ウェルカムメールを送信する」 $User表示名 # メッセージをカスタマイズする $htmlHeaderUser = “<h2>新しいユーザー" + $User.表示名 + "</h2>" $htmlbody = $htmlheaderUser + $htmlline 1 + $htmlline 2 + $htmlline 3 + "" $HtmlMsg = "</body></html>" + $HtmlHead + $HtmlBody # メッセージ本文を構築する $MessageBody = @{ コンテンツ = "$($HtmlBody)" コンテンツタイプ="html" } # サインインしているユーザーのメールボックスに下書きメッセージを作成する $NewMessage = 新しい MgUser メッセージ -ユーザー ID $MsgFrom -本文$MessageBody -宛先 $EmailRecipient - 件名$MsgSubject #メッセージを送信します送信-MgUser メッセージ -ユーザー ID $MsgFrom -メッセージ id $NewMessage.Id } # エンド For Each ユーザー

# 新しいメールボックスのそれぞれにウェルカム電子メールメッセージを作成して送信する

フォーリーチ ($利用者で $ユーザー) {

# メールボックスのプライマリ SMTP アドレスを使用して受信者を追加する

$電子メール受信者 = $利用者.プライマリSmtpアドレス

$電子メールアドレス = @{住所 = $利用者.プライマリSmtpアドレス}

$電子メール受信者 = @{電子メールアドレス = $電子メールアドレス}

書く–ホスト「ウェルカムメールの送信」 $利用者.表示名

# メッセージをカスタマイズする

$ユーザー = “ + $利用者.表示名 + “

$htmlbody = $ユーザー + $htmlline1 + $htmlline2 + $3 + “

$HtmlMsg = “ + $Htmlヘッド + $体の中

# メッセージ本文を構築する

$メッセージボディ = @{

コンテンツ = 「$($HtmlBody)」

コンテンツタイプ = 'html’

}

# サインインしているユーザーのメールボックスに下書きメッセージを作成する

$新しいメッセージ = 新機能–Mg ユーザーメッセージ –ユーザー ID $メッセージの差出人 –体 $メッセージボディ –宛先 $電子メール受信者 –件名 $メッセージの件名

#メッセージを送信します

送信–Mg ユーザーメッセージ –ユーザー ID $メッセージの差出人 –メッセージ ID $新しいメッセージ.身分証明書

} # エンド ForEach ユーザー

他の多くの PowerShell コマンドレット、特に Exchange Online のコマンドレットとは異なり、グラフ API と対話するときは、API が必要とする入力形式を使用するように細心の注意を払う必要があります。たとえば、ターゲットメールボックスのプライマリ SMTP アドレスを取得し、その文字列を使用して受信者をメッセージに追加することが可能であるとします。不幸なことに、それはそうではなく、Graphが幸せになる前に、正しい形式の要素を持つ配列を構築する必要があります。

受信者の処理

上記のコードは、1 つの TO: 受信者を追加する手順を示しています。他の受信者を追加する場合は、同じ種類の入力配列を作成します。たとえば、メッセージに BCC 受信者のカップルを追加するとします。配列で受信者を宣言します (または PowerShell を使用してソースから取得します)。

$BCCRecipients = @(“Brian.Weakliam@Office365itpros.com"、"Kim.Akers@Office365itpros.com")

$BCC受信者 = @(「Brian.Weakliam@Office365itpros.com」, 「Kim.Akers@Office365itpros.com」)

次に、入力配列を作成します。

$BCC = $BCCRecipients |% {@{電子メールアドレス = @{ アドレス = $_ }} } }

$BCC = $BCC受信者 | % {@{電子メールアドレス = @{ 住所 = $_ }}}

配列は次のようになります。

$BCC 名前の値 —- —– 電子メールアドレス {アドレス} 電子メールアドレス {アドレス}

$BCC

名前価値

—— ——–

電子メールアドレス {住所}

配列の値は次の方法で確認できます。

$BCC。価値観 名前の値 —- —– 住所 Brian.Weakliam@Office365itpros.com アドレス Kim.Akers@Office365itpros.com

$BCC.価値観

名前価値

—— ——–

住所ブライアン.弱いリアム@Office365itpros.com

住所金.エイカーズ@Office365itpros.com

SDK開発者は、より簡単に私たちに好意を与えることができますメッセージに受信者を追加します。メッセージ構造が入れ子になった値を要求する理由には論理があると確信していますが、SDK を使用するようにコードを更新するように人々を説得することは容易ではありません。

添付ファイルの追加

メッセージに添付ファイルを追加することは、SDK 開発者が PowerShell 開発者に対して複雑さを隠すもう 1 つの場所です。現時点では、添付ファイルを追加するには、Base64 エンコードバージョンのファイルを作成し、入力配列に含める必要があります。例えば：

$AttachmentFile = “c:tempようこそ Office365ITPros.docx" $EncodedAttachmentFile = [convert]::ToBase64String((コンテンツの取得$AttachmentFile -エンコーディングバイト)) $MsgAttachment = @{ “@odata.type"= “#microsoft.graph.fileAttachment" 名前 = ($AttachmentFile -スプリット '\’)[-1] コンテンツバイト = $EncodedAttachmentFile }

$添付ファイル = “c:tempようこそ Office365ITPros.docx"

$ファイルをエンコード = [convert]::トベース64文字列((取得–コンテンツ $添付ファイル –エンコーディングバイト))

$メッセージの添付ファイル = @{

“@odata.タイプ"= “#microsoftグラフ.ファイル添付ファイル"

名前 = ($添付ファイル –割る '\’)[–1]

コンテンツバイト = $ファイルをエンコード

}

今構築した入力配列は次のようになります。

$MsgAttachment 名前の値 —- —– コンテンツバイト・ウエスド・ブッカ・ブガ・アア・ア・アイクド7xliMzwEAAokaaaagagcw0nvbnヴェルブンヴェルヴヴルヴルズエクスント.. 名前ようこそOffice365ITPros.docx @odata.タイプ#microsoftグラフ.ファイル添付ファイル

$メッセージの添付ファイル

名前価値

—— ——–

コンテンツバイトウエスドブッカブブガイアアアイクド7xlimzwEAAOkaaataAgCW0bnbnRfVWZXNd…

名前ようこそ Office365ITPros.ドルクシ

@odata.種類 #microsoftグラフ.ファイル添付ファイル

添付ファイルをメッセージに含めるには、配列を 添付ファイル パラメータ 新しいMgUserメッセージ.添付ファイルは、期待どおりに表示されます (図 2)。

$NewMessage = 新しい MgUser メッセージ – ユーザー id $MsgFrom – 本文$MessageBody -宛先$EmailRecipient – 件名$MsgSubject -添付ファイル$MsgAttachment

$新しいメッセージ = 新機能–Mg ユーザーメッセージ –ユーザー ID $メッセージの差出人 –体 $メッセージボディ –宛先 $電子メール受信者 –件名 $メッセージの件名 –添付ファイル $メッセージの添付ファイル

良い機能性;簡単になる可能性があります。

再選を嘆願し、時には政治家は、彼らが多くのことをしたが、まだやるべきことがたくさんあると主張する。PowerShell 用のマイクロソフトグラフ SDK を使用して、Exchange オンラインを介してメッセージを作成して送信するのと同じ感覚を得ています。利用可能な機能はたくさんありますが、特に、アニメーション化されていない機能にアクセスするのは難しいです。 メールメッセージの送信 コマンドレット。良いドキュメントの欠如は、さらなる障壁です。

現在、PowerShell 用のマイクロソフトグラフ SDK は、基になるグラフ API の動作を模倣しています。開発の初期段階を考えると、それは適切で必要です。しかし、SDK を受け入れ、使用するように人々を説得するには、開発者は、SDK コマンドレットを使用して、管理者が Graph の機能にアクセスする方が簡単にする必要があると思います。

[ad_2]

未分類

Posted by admin