---
sourceDocument: Xanadu の Now Platform 機能
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/servicenow-platform

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu の Now Platform 機能

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# \[メールボックスの取得\] アクティビティ

# \[メールボックスの取得\] アクティビティ {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

\[メールボックスの取得\] アクティビティは、指定されたユーザーのメールボックスまたは Microsoft Exchange サーバーのすべてのメールボックスを取得します。
このアクティビティは、Microsoft Exchange の [Get-Mailbox](https://technet.microsoft.com/en-us/library/bb123685(v=exchg.160).aspx) コマンドを実装します。  
ワークフローエディターでこのアクティビティにアクセスするには、\[ カスタム \] タブを選択し、 カスタムアクティビティExchangeメールボックス.  
注:  
このアクティビティによって、Geneva より前のリリースで使用可能な同じ名前の Exchange アクティビティが置き換えられます。廃止されたアクティビティを使用する前のバージョンで作成されたワークフローがある場合、このワークフローは、Geneva にアップグレードした後も引き続き正常に機能します。ただし、新しいワークフローはすべて、このアクティビティのカスタムバージョンを使用する必要があります。このアクティビティは [PowerShell アクティビティデザイナー](https://www.servicenow.com/docs/UFnszfTo3VmCYtz2_0Ir3A "PowerShell アクティビティは、Microsoft PowerShell を使用してホストからワークフローにデータを返すように設定されています。")で作成されており、ワークフローアドミニストレーターは入力変数と出力変数を[データバス](https://www.servicenow.com/docs/Vw1WxdA4dk58cwhbyE8tvQ#t_ReuseDataInTheActivityDesigner "ワークフローエディターの [データ] タブには、現在のワークフローで使用されている、データを生成するすべてのカスタムアクティビティがリストされ、そのデータが他のカスタムアクティビティで再利用するために表示されます。")に保存できます。

## 入力変数

{#r_GetMailboxActivity__table_n4h_h2v_qt__entry__2}

| 変数 | 説明 |
|-|-|
| hostname | アクティビティがやり取りする Exchange サーバーのホスト名。この変数に IP アドレスを入力しないでください。 |
| domain | Exchange サーバーのアサイン先ドメインの名前。 |
| ユーザー | このアクティビティがメールボックスを取得するユーザー。ユーザーを指定しない場合、Exchange サーバーのすべてのメールボックスが取得されます。アクティビティは、この値を Exchange に Identity Exchange 変数として渡します。 |
| parameters | JavaScript Object Notation (JSON) で作成され、Exchange サーバーに渡されるオプションのパラメーター。Exchange アクティビティは、PSCredential オブジェクトなどのオブジェクトを参照するパラメーターを渡すことができません。プレーン テキストは、このデータ型を必要とするパラメーターの SecureString オブジェクトに自動的に変換されます。 アクティビティ変数からのパラメーターなど、重複したパラメーターや誤った形式の JSON を指定するアクティビティを保存しようとすると、警告メッセージが表示されます。 注: ForceUpgrade などのスイッチパラメーターを渡す場合は、"parameter":"true" の形式を使用する必要があります。 |
[表 : 1. \[メールボックスの取得\] 入力変数]

{#r_GetMailboxActivity__table_n4h_h2v_qt}

## 出力変数

{#r_GetMailboxActivity__table_q4y_k2v_qt__entry__2}

| 変数 | 説明 |
|-|-|
| result | success または failure。 |
| エラー | 操作が失敗した場合のメッセージを入力します。 |
| output | Exchange サーバーの未加工の XML ペイロード。このデータには、すべての Exchange 属性が含まれます。 |
[表 : 2. \[メールボックスの取得\] 出力変数]

{#r_GetMailboxActivity__table_q4y_k2v_qt}

## 条件

{#r_GetMailboxActivity__table_evc_n2v_qt__entry__2}

| 条件 | 説明 |
|-|-|
| 成功 | アクティビティは、指定されたメールボックスの属性の取得に成功しました。 |
| 失敗 | アクティビティは、指定されたメールボックスの属性の取得に失敗しました。 |
[表 : 3. \[メールボックスの取得\] 条件]

{#r_GetMailboxActivity__table_evc_n2v_qt}