[メールボックスの作成] アクティビティ

[メールボックスの作成] アクティビティは、Active Directory ユーザーがまだ存在しない場合、新しい Active Directory ユーザーとこのユーザーの Microsoft Exchange メールボックスを作成します。

このアクティビティは、Microsoft Exchange の New-Mailbox コマンドを実装します。

ワークフローエディターでこのアクティビティにアクセスするには、[ カスタム ] タブを選択し、 カスタムアクティビティ > Exchange > メールボックス.

注:

このアクティビティによって、Geneva より前のリリースで使用可能な同じ名前の Exchange アクティビティが置き換えられます。廃止されたアクティビティを使用する前のバージョンで作成されたワークフローがある場合、このワークフローは、Geneva にアップグレードした後も引き続き正常に機能します。ただし、新しいワークフローはすべて、このアクティビティのカスタムバージョンを使用する必要があります。このアクティビティは PowerShell アクティビティデザイナーで作成されており、ワークフローアドミニストレーターは入力変数と出力変数をデータバスに保存できます。

入力変数

表 : 1. [メールボックスの作成] 入力変数

変数	説明
hostname	アクティビティがやり取りする Exchange サーバーのホスト名。この変数に IP アドレスを入力しないでください。
domain	Exchange サーバーのアサイン先ドメインの名前。 重要: MID サーバーは、Exchange サーバーと同じドメインに存在する必要があります。
first_name	ユーザーの名前 (名)。
middle_initial	ユーザーのミドルネームのイニシャル。
last_name	ユーザーの名前 (姓)。
エイリアス	メールボックスアドレスの表示名、メールアドレスのうちの @ 記号の左の部分。別名を指定しない場合、First name.Last name が別名として使用されます。また、オプションのパラメーターで指定されていない場合、別名はユーザーのプリンシパル名 (UPN) としても使用されます。
パスワード	新しいメールボックスに使用するパスワード。パスワードは、ターゲット ホストに送信されるときに暗号化されます。
parameters	JavaScript Object Notation (JSON) で作成され、Exchange サーバーに渡されるオプションのパラメーター。Exchange アクティビティは、PSCredential オブジェクトなどのオブジェクトを参照するパラメーターを渡すことができません。プレーン テキストは、このデータ型を必要とするパラメーターの SecureString オブジェクトに自動的に変換されます。 アクティビティ変数からのパラメーターなど、重複したパラメーターや誤った形式の JSON を指定するアクティビティを保存しようとすると、警告メッセージが表示されます。 注: ForceUpgrade などのスイッチパラメーターを渡す場合は、"parameter":"true" の形式を使用する必要があります。

出力変数

表 : 2. [メールボックスの作成] 出力変数

変数	説明
result	success または failure。
エラー	操作が失敗した場合のメッセージを入力します。
output	Exchange サーバーの未加工の XML ペイロード。このデータには、すべての Exchange 属性が含まれます。

条件

表 : 3. [メールボックスの作成] 条件

条件	説明
成功	アクティビティは、指定されたユーザーの新しいメールボックスの作成に成功しました。そのユーザーの Active Diectory アカウントが存在しない場合、このアクティビティは新しいアカウントの作成に成功しました。
失敗	アクティビティは、指定したユーザーの新しいメールボックスまたは Active Directory アカウントの作成に失敗しました。