Information

Azure ADのゲストが参加したか否かを確認するPowerShellのFunctionです。

まだゲストが参加していない場合は、参加が完了するまで処理し続け、参加後に通知します。

指定したメールが存在しない場合や、対象のメールの所有者がゲスト以外（メンバー）の場合は処理が中断されます。

Prep

• Windows10 PC
• SlackのWebhook URL作成（例えばIncoming-Webhookなど）※参考Qiita
• AzureADのユーザー参照権限取得

How to Use

1. 二つのPS1ファイルをダウンロードして、任意のフォルダに配置してください ※補足1
2. CheckAADGuestStatus_config.ps1の各パラメーターをエディタ（メモ帳やVSCodeなど）で編集します。 ※補足2
3. PowerShell(管理者権限)を起動し、PS1をダウンロードした同じフォルダに移動します。※補足3
4. PowerShellの画面上で.\CheckAADGuestStatus.ps1と入力してEnterを押下します。
5. 「CheckAADGuestStatusのコマンドが実行できるようになりました。」のメッセージが表示されることを確認します。
6. PowerShellの画面上でCheckAADGuestStatusと入力してEnterを押下します。 ※補足4
7. メールアドレスの入力が求められるため、参加状況を確認したいゲストユーザーのメールアドレスを入力します。
8. ユーザー認証が求められるため、招待者（または招待者が所属する組織アカウント）のメールアドレスで認証を行います。
9. 結果を確認します。（Slackの通知またはPowerShell画面を確認）
10. 終わり

補足1

ファイルのダウンロードは例えばこのように実施してください。右クリ保存でも〇です。

1. 本ページの緑色のCodeボタンをクリック
2. Download ZIPをクリック
3. ZIPを解凍

補足2

• 必須

$Webhook_default

事前準備で用意したSlackアプリのWebhook URLを登録します。

EX）$Webhook_default = "https://hooks.slack.com/services/xxxx/yyyy/zzzz"

※上記URLは利用できません

• 任意

$waitSecond_default

ループの待機時間を設定します。デフォルトは60秒です。

$image

Slack通知に表示するイメージを選択します。任意項目のため編集は省略しても良いです。

入力する場合はファイルの直接リンクを指定します。

補足3

• 管理者権限でPowerShellを開く

• ファイルを保存したフォルダに移動

※画像は「C:\temp\CheckAADGuestStatus-main」にファイルを配置した場合の例

補足4

UnauthorizedAccessが発生する場合はPS1ファイルのプロパティを修正してください。

FYI

• 細かい使い方はget-help CheckAADGuestStatus -fullで確認してください。
• WebhookのURLやループ待機時間は引数でも設定できます。
• Webhookの作り方はSlack公式を参照するのも良いです。
• PS1ファイルを実行したPowerShellプロセスのみで動きます。コマンドを利用する機会が多い人はこの記事などを参考に設定してみてください。