NO IMAGE

Office 365 で利用可能なメッセージング関連 API について

Office 365 の一部である Exchange Online ではメールや予定表など様々な機能がありますが、これらの各ユーザーのメールボックス上の情報にプログラムからアクセスするためにいくつかの API が用意されています。 様々なアプローチがあるため API も多数ありますが、ここでは EWS / Office 365 API (Outlook REST API) / Microsoft Graph にフォーカスを当てて説明します。 EWS EWS (Exchange Web Services) は、もともとオンプレミスの Exchange 2007 以降で導入された W...

Format-List コマンドの結果をプロパティの名前でならべかえる

Get-Mailbox などのコマンドの実行結果を fl (Format-List) で出力すると各プロパティが表示されますが、もしかするとこれをアルファベット順で表示させたいという状況があるかもしれません。 こんな時はこちらのぺージを参考にするとよいでしょう。 ただしこの方法ではもともと表示されていた以下の情報が表示されません。 PSComputerName PSShowComputerName RunspaceId これらはリモート PowerShell 接続に関する内容のため、特に意識する必要はない情報ですが、もし必要ということであれば Get-Mem...

NO IMAGE

Export-TransportRuleCollection コマンドの中身を見る

トランスポート ルール関連のコマンドとして Export-TransportRuleCollection コマンドと Import-TransportRuleCollection コマンドがあります。 基本的にこれらはその名前の通りトランスポート ルールのエクスポートとインポートを行うためのコマンドであり、設定内容を取得したり確認したりするためのものではありません。 設定内容を取得するには Get-TransportRule コマンドを使用するべきです。 ですが Export-TransportRuleCollection コマンドの出力内容としては XML でラップされた New-...

代理人の設定や非公開の予定を表示する権限を PowerShell で確認する方法

いままでは代理人の設定や非公開の予定を表示するかどうかについては、Outlook や EWS でないと確認ができませんでした。これが Exchange Online の PowerShell でできるように、しれっと機能が強化されています。ただし予定表フォルダー限定です。 例えば EXO の OWA で以下のように代理人と非公開の予定を表示する設定を行ったとします。 そして以下のようにコマンドを実行します。ユーザー名やフォルダー名は適宜読み替えてください。 すると以下のように SharingPermissionFlags に Delegate と CanVie...

Remote PowerShell コマンドの既定の出力内容

Exchange Online の PowerShell に接続して Get-Mailbox コマンドを実行すると、既定で Name / Alias / ServerName / ProhibitSendQuota の 4 つが出力されているはずです。 Get-Mailbox コマンドの結果を fl すると分かるように本当はもっとたくさんの属性を持っていますが、コマンドだけを実行して何を表示するのかを指定しなかった時に既定で何を出力するのかは、PowerShell モジュールの設定で決められています。 どのように設定されているのかを確認するためには、まずはいつも通り New-PSSes...

NO IMAGE

多要素認証を使用した Exchange Online PowerShell の裏側

TechNet にも記載の通り、Exchange Online に接続する PowerShell で MFA が利用できるようになっています。 Remote PowerShell の制約で OAuth が使えなかったはずですが、動作を見るとどうも OAuth を使っているように見えます。 今回は内部動作を見てみたいと思います。 TechNet に従って Exchange 管理センターからモジュールをダウンロードすると、Microsoft Exchange Online PowerShell というアプリケーションがインストールされています。 このアプリケーションを起動すると Power...

NO IMAGE

Exchange 管理シェルとリモート PowerShell のデータ型の違い

Exchange 管理シェルとリモート PowerShell では、データ型が異なる場合があります。 例えばトランスポート ルールで承認者が設定されている場合は ModerateMessageByUser で確認できます。 Exchange 管理シェルでは、以下の通り System.Array クラスを継承している RecipientIdParameter 型の配列です。 一方、リモート PowerShell では以下の通り ArrayList 型です。 この型の違いが、要素数を取得する際に影響します。 RecipientIdParameter 型の配列では Length プロパ...

NO IMAGE

GetRoomLists / GetRooms の制限

EWS で会議室一覧配布グループを使用する際、GetRoomLists や GetRooms を使用します。 GetRoomLists で返される会議室一覧配布グループの数には制限はありませんが、GetRooms で返される会議室の数は 100 件に制限されています。 検証のため、まずは会議室一覧配布グループを作り、110 個のメンバーを追加しておきます。 以下のような状態になります。 そして、C# / EWS Managed API で以下のようなコードを書きます。 結果、特に例外は発生しませんが、100 件しか取得できません。 これはスロットリング ポリシーではなく、1...

NO IMAGE

PowerShell のプロンプトを変更する

PowerShell を利用する際に、コマンドを実行した時刻が記録されると便利だと思うことがあります。 もちろんその都度 Get-Date などを実行してもいいですが、少し面倒です。 そんな時はプロンプト、「PS >」の部分を変更してしまうと便利です。 まずは現在時刻をプロンプトに表示してみましょう。 Exchange 管理シェル風に、色を付けることもできます。 パスが長くなるとコマンドを入力できる文字数が減っていやだというときは、改行してしまうこともできます。 現在のプロンプトの設定を確認するには以下を実行して確認できます。 元に戻すには Powe...

NO IMAGE

Exchange サーバーのバージョン番号と製品名を相互変換する

「この CU のバージョン番号はなんだったか?」や、逆に「このバージョン番号は CU いくつだ?」と思うことが多々あります。もちろん TechNet などにも記載がありますが、わざわざ表示して確認するのも少し面倒。 そこで Get-ExchangeBuildNumber を使用します。使い方は README に書いてある通り、簡単ですね。リポジトリの名前は Get-ExchangeBuildNumber ですが、製品名からバージョン番号を取得する Get-ExchangeBuildNumber と、バージョン番号から製品名を取得する Get-ExchangeProductName が含まれて...