PowerShellを使ってExchange Onlineのモジュールを使う際のTIPSです。このTIPSはコマンドをコンソールで実行する場面では使いませんが、PowerShellのバッチスクリプトを開発・テストするときに知っておくと役に立ちます。

まず、PowerShellでExchange Onlineに接続する

PowerShellでExchange Onlineに接続するには「Connect-ExchangeOnline」を実行します。
バッチスクリプトで接続コマンドを使う際には「Credential」オプションで認証情報を渡します。

$user = "XXX"
$pass = "XXX" | ConvertTo-SecureString
$credential = New-Object System.Management.Automation.PSCredential $user,$pass

# ExchangeOnlineに接続
Connect-ExchangeOnline -Credential $credential

これを実行すると、V1とV2コマンドの違いに関する情報が表示され、接続が完了します。

接続コマンドを複数回実行するとエラーになる

バッチスクリプトの開発・テストをしている場面で上記の接続コマンドを実行するとエラーが表示されることがあります。

エラーメッセージをテキストに起こしたのが以下のものです。メッセージの通り、このエラーはサーバーに対して最大接続数を超えるセッションをはろうとしたことにより発生したエラーです。

ISE等で開発を行う際には、スクリプトの実行を停止してもセッションや変数は自動では解放されないためにこのようなことが起こり得ます。

New-ExoPSSession : リモートサーバー outlook.office365.com からのデータの処理に失敗し、次のエラーメッセージが返されました: [AuthZRequestId=d1175b9e-f07f-4a3e-a954-dd7dd4bce7c3][FailureCategory=AuthZ-Au
thorizationException] ポリシーパーティ MaxConcurrency に対して許可されている最大接続数 3 を超過したため、実行空間の作成に失敗しました。既存の実行空間を閉じて終了してからやり直してください。

このエラーを回避する方法

結論から言うと、以下の通り分岐条件をいれればこのエラーは回避できます。

$user = "XXX"
$pass = "XXX" | ConvertTo-SecureString
$credential = New-Object System.Management.Automation.PSCredential $user,$pass

$PSSession   = Get-PSSession | Select-Object -Property State,Name
$isConnected = ((@($PSSession) -like '@{State=Opened; Name=ExchangeOnlineInternalSession*').Count -gt 0)
If ($isConnected -eq $false) 
{
    #ExchangeOnlineに接続
    Connect-ExchangeOnline -Credential $credential
}

この分岐条件は何をしているのか？

「Get-PSSession」コマンドを使って現在のセッション情報を見て、Exchange Onlineに対してオープンになっているセッションがあるかどうかを確認しています。オープンになっているセッションが無い場合は接続コマンドを実行します。

反対に、既にオープンになっているセッションがある場合は接続コマンドを実行しません。

Get-PSSession

 Id Name            ComputerName    ComputerType    State         ConfigurationName     Availability
 -- ----            ------------    ------------    -----         -----------------     ------------
  1 ExchangeOnli... outlook.offi... RemoteMachine   Opened        Microsoft.Exchange       Available
  2 ExchangeOnli... jpn01b.ps.co... RemoteMachine   Opened        Microsoft.Exchange

おまけ：コンプライアンスセンターへの接続でも同じ方法を使う

この方法は、アイテム保持ポリシーをバッチスクリプトで操作する等のためにコンプライアンスセンターへ接続する場面でも使えます。

$user = "XXX"
$pass = "XXX" | ConvertTo-SecureString
$credential = New-Object System.Management.Automation.PSCredential $user,$pass

$PSSession   = Get-PSSession | Select-Object -Property State,Name
$isConnected = ((@($PSSession) -like '@{State=Opened; Name=ExchangeOnlineInternalSession*').Count -gt 0)
If ($isConnected -eq $false) 
{
    #ExchangeOnlineに接続
    Connect-ExchangeOnline -Credential $credential

    #コンプライアンスセンターに接続
    Connect-IPPSSession -UserPrincipalName $user
}

以上です。