Exchange Online Powershell V2 module 更新情報とGet-EXOMailbox確認

Exchange Online Powershell V2 moduleの更新

Exchange Online Powershell V2 moduleは2019年のIgniteで発表されたもので、大量のメールボックスなどを取得する際にREST APIを利用して高速に処理できることが可能なものとなっています。
特にパイプラインで渡して処理させるとマルチスレッドで高速らしいです。上記サイトにある以下の例では100メールボックスに対するGet-EXOMailboxStatisticsで、foreachが約900秒かかっているのに対しパイプラインでは約50秒です。

Exchange Online Powershell V2のcmdlet

V2はVersion 1も内包していますしV1も現役です。というよりV2はデータ取得時の高速化が目的なので以下の9つのGet系Cmdletしかありません。（Connect入れると10個）
  • Get-EXOMailbox
  • Get-EXORecipient
  • Get-EXOCASMailbox
  • Get-EXOMailboxPermission
  • Get-EXORecipientPermission
  • Get-EXOMailboxStatistics
  • Get-EXOMailboxFolderStatistics
  • Get-EXOMailboxFolderPermission
  • Get-EXOMobileDeviceStatistics
今回このV2モジュールの更新情報が発表されたのでご紹介します。

更新情報

今回の更新は以下の3つ。
  • 管理権限を付与された他テナントへの接続（ゲストとかで管理者指定されたときですかね）
  • アイデンティティにname, aliasも指定できるようになった上で位置指定パラメーター化
  • エラーハンドリングその他バグフィックス（修正内容はこちら）

アイデンティティが位置指定パラメーター化は地味に嬉しい、ちゃんとしたスクリプト書くときならともかく、毎日のちょっとした運用業務に毎回アイデンティティをパラメーター指定するのめんどいですからね。

ただ・・
Please note that using alias or name slows down the performance of V2 cmdlets and hence it is not recommended to use this option
とあり、V2の高速化をフルに活かしたいならIdentityパラメーター指定してアドレスかUPN渡してあげた方がいいみたいですね、まぁそりゃそっか。
現在この更新モジュールはパブリックプレビュー中で、もうじきGAだそうです。

EXO V2 moduleのGet-EXOMailboxを試す

EXO V2 moduleが世の中に出たのは少し前のことになりますが、今更ながら少しどんなものか確認してみました。
まずはモジュールを以下サイト記載の方法でダウンロード・インストールしましょう。
完了後、以下のcmdletをWindows Powershellで実行します。
※現在のところPowershell Core (Ver.6 – 7)では動かないのでご注意ください。
  1. Import-Module ExchangeOnlineManagement
  2. Connect-ExchangeOnline

ここでクレデンシャルを正しく入力すると以下がコンソールに表示されます。

—————————————————————————-
We have released new management cmdlets which are faster and more reliable.
|————————————————————————–|
|    Old Cmdlets                    |    New/Reliable/Faster Cmdlets      |
|————————————————————————–|
|    Get-CASMailbox                |    Get-EXOCASMailbox                |
|    Get-Mailbox                    |    Get-EXOMailbox                    |
|    Get-MailboxFolderPermission    |    Get-EXOMailboxFolderPermission    |
|    Get-MailboxFolderStatistics    |    Get-EXOMailboxFolderStatistics    |
|    Get-MailboxPermission          |    Get-EXOMailboxPermission          |
|    Get-MailboxStatistics          |    Get-EXOMailboxStatistics          |
|    Get-MobileDeviceStatistics    |    Get-EXOMobileDeviceStatistics    |
|    Get-Recipient                  |    Get-EXORecipient                  |
|    Get-RecipientPermission        |    Get-EXORecipientPermission        |
|————————————————————————–|
To get additional information, run: Get-Help Connect-ExchangeOnline
Please send your feedback and suggestions to exocmdletpreview@service.microsoft.com
—————————————————————————-

ご丁寧に新旧の対応表を出してくれてますね。

後は上記のCmdletを実行可能です。

PropertySets

Get-EXOMailbox name
と打てばnameさんのメールボックス情報が表示されますが、V1と違い返ってくる属性の数が少ないです。
実はV2では既定で対象オブジェクトの全属性が返ってこなくなりました。Get-ADUserみたいな感じかな。これは大量のデータを取得する際に不必要な属性情報を全対象分取得すると遅くなるのを避けるためですね。
他の属性情報を取得する方法は2つあります。
  1. Propertiesパラメーターに欲しい属性名を渡す
  2. PropertySetsパラメーターを使う
1個目の方法は分かりやすく無駄がないですが毎回やるの面倒過ぎですよね。
2個目の方法は新しいやり方で、属性ごとにグルーピングされたProertySetsという概念が出たのでそれを指定する方法です。
例えばGet-EXOMailboxの場合指定しなかった場合の既定値は”Minimum”で、返ってくる属性は以下の通り。
  • Alias
  • DisplayName
  • DistinguishedName
  • EmailAddresses
  • ExchangeVersion
  • ExternalDirectoryObjectId
  • Guid
  • Id
  • Name
  • OrganizationId
  • PrimarySmtpAddress
  • RecipientType
  • RecipientTypeDetails
  • UserPrincipalName
詳細はこちら: Get-EXOMailbox property sets
用途に応じてPropertySetsを選んで無駄を省きましょうということですね。PropertySetsはカンマ区切りで複数指定することもできますし、Propertiesとセットで使うこともできます。
全属性取得するには？
“All”を指定すると全属性が返ってきてくれるのですが・・
We highly discourage using the PropertySets parameter with the value All because it slows down the cmdlet and reduces reliability. Always use the PropertySets and Properties parameters to retrieve only the requires properties.
“All”は遅くなるし安定性を損なうから極力やめとけだそうです、まぁそうですね。

EXO V2 moduleのこれから

高速化が売りなので日時のバッチ処理や全社員のメールボックス情報の出力などの場面ではかなり有用そうな気がします、新規にスクリプトを書く際には是非検討したいですね。
高速化とは別に、2020年10月で廃止されるExchange Onlineに対するBasic認証の廃止もこのEXO V2 moduleで証明書を利用して解消させたいらしいので、その情報が早くほしいですね。
というのも現状日次のメールボックスに対する処理を自動化するのに、ID/PWによるBasic認証で行っているのでスクリプトの書き換えが発生しますからね。テスト期間が必要なので早ければ早いほどありがたいです。

コメント

コメントを投稿

Popular Posts

Outlookの検索フォルダー（Search Folders）配下に未読で件名が空のメールが 沢山ある

見に覚えのない未読メールが数千も？ 数千の未読メールが検索フォルダー配下の未読のメールに表示されることがあるそうです。 発生するのはOutlook2013以降。 Outlook の検索フォルダーに、件名が空白の予期しないメール アイテムが表示されます。 – Outlook Outlook 2013、Outlook 2016、Outlook 2019 または Outlook Office 365 ですべてのメール アイテム用の検索フォルダーを作成すると、フォルダーに件名が空白の予期しないアイテムが含まれます。 これらの項目にマウスを移動すると、次の情報が表示されます。 フォルダー内: PersonMetadata PersonMetadata フォルダは、 Outlook Customer Manager (OCM) によって作成および使用されます。 フォルダーは通常、Outlook ユーザー インターフェイスの他の部分から隠されています。 ただし、検索フォルダーには、このフォルダーのメール アイテムが含まれます。 これらの項目には空白の件名がありますが、OCM によってアクティブに使用されているため、削除または変更しないでください。 検索フォルダーの制約により、隠しフォルダー内のメール アイテムが含まれます。 廃止後も、PersonMetaData フォルダーとその中のアイテムは期間限定で使用できます。 このフォルダー内のアイテムを変更または削除すると、アイテムが再作成されたり、新しいアイテムが表示されたりする場合があります。 近い将来にサービスが変更されると、PersonMetaData フォルダーとそのアイテムがサービスから削除されます。 それまでは、次の回避策を使用して、非表示フォルダーのメールアイテムが検索結果に含まれないようにしてください。 [検索フォルダー] を右クリックし、[この検索フォルダーのカスタマイズ] をクリックします。 [参照] をクリックし、[サブフォルダの検索] オプションの選択を解除します。 含めるフォルダを手動で選択します。 要諦 検索フォルダー（Search Folders）下では、通常では見えないPersonMetaDataフォルダーとその中のアイテムが表示されてしまう。これはシステムが利用するものなので消してもまた出てきてしまう...
Read more »

[Exchange] 会議室の予定が主催者の名前になってしまうのが嫌な場合

Teams Roomsシステムとかで使ったり ExchangeやExchange Online上でリソースメールボックスを作り、会議室としてユーザーにOutlookやOWAから予約させたり予定を確認してもらうことがあります。Teams Roomsシステムなど、Teamsと連携した会議室システムの導入も増えてリソースメールボックスの作成も増えてるかもしれません。 Microsoft Teams Rooms 主催者の名前じゃなくて会議のSubject（タイトル）を見せたい デフォルトでリソースメールボックスの予定表は、予約された会議のSubject（タイトル）ではなく、予約者の表示名になります。 これは会議室を確認・予約しようとするユーザーが不特定多数いる場合を考えると、センシティブであったりショッキングな会議タイトルを秘匿できるので有用な設定です。 （”人員削減計画会議”とか”A社買収の計画について”とか見せたくないと思うので） しかし場合によっては予約者ではなく会議のタイトルが見える方がありがたい場合もあります。 そうした場合は会議室であるリソースメールボックスの以下の設定をを変更します。リソースメールボックスとして他にも設定しそうなパラメーターと共に紹介します。 Cmdlet Set-CalendarProcessing <リソースメールボックスの名前> Parameter -BookingWindowInDays 何日後の予定まで予約可能か -MaximumDurationInMinutes 1会議の最長時間を分で -AutomateProcessing 予約を自動で承諾、処理するか 選択肢はNone, AutoUpdate, AutoAccept オンプレミスかExchange Onlineか、GUIかPowerShellでデフォルト値が異なるようです。 -DeleteSubject 予約のSubject（タイトル）を削除するか この値がデフォルトTrueなので作ったまんまだと会議のタイトルはリソースメールボックス上の予定には表示されません。 -AddOrganizerToSubject 予約者の表示名を予約のSubject（タイトル）に追加するか この値がデフォルトTrueなので予約のタイトルには予約...
Read more »

Edge (Chromium版) で個人アカウントでのサインインを禁止する

Edgeに個人アカウントでのサインインをブロックする Block personal accounts from syncing in Microsoft Edge with Microsoft Intune | Peter Klapwijk – In The cloud 24-7 Today another blog post related to the new Microsoft Edge Chromium based browser and managing the browser with Microsoft Intune (Microsoft Endpoint Manager). This time about blocking personal accounts from syncing in Microsoft Edge. In the new Edge browser we have to option to sign-in to the browser and sync data like Favorites, Passwords and more. Chromium版Edge Chromium版のEdgeが数ヶ月前に正式リリースされました。Chromium版になってから動作が速くなったり、シンプルなUIでわりといいんじゃないでしょうか。特に自社Office 365内をインターネットと同じ感覚で検索できるMicrosoft Searchは便利ですね。 こうなってくると社内標準ブラウザーを定めている企業で標準のEdgeへの変更も大分視野に入ってくるのではないでしょうか、特に標準がまだIEだったりすると先がなさそうですからね。 個人的には依然EdgeよりChromeが好きなんですが、Office 365などと使うのにMicrosoft製のブラウザーの方が将来的に安心な気もするので業務利用ならEdgeでもいいかなと思います。 Edgeはサインインできます このEdgeですが、AADアカウントや個人のマイクロソフトアカウントでサインインができます。 ChromeやFirefoxをお使いなら想像がつくかと思いますが、お気に入り、アクセス履歴、パスワードなどをアカウントごとに同期できるので、同一アカウントでサインインすれば会社のEdgeでお気に入りに...
Read more »