Exchange 管理者活動Exchange Administrator Activities

重要

このバージョンの Orchestrator はサポートが終了しました。 orchestrator 2019 にアップグレードすることをお勧めします。This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

次の構成手順は、Exchange 管理統合パックで実行されるすべての活動に適用されます。The following configuration instructions apply to all activities that are performed in the Exchange Admin Integration Pack. 特定の Exchange 管理アクティビティの詳細な構成に関するトピックには、これらの一般的な手順へのリンクが含まれています。The detailed configuration topics for specific Exchange Admin activities all contain links back to these general instructions.

このトピックの各手順は、 Orchestrator Runbook Designerの runbook ウィンドウに配置されているアクティビティで実行されます。Each procedure in this topic is performed on an activity that has been placed in the runbook window of the Orchestrator Runbook Designer.

活動のプロパティActivity properties

各アクティビティは、必須または省略可能なプロパティのセットを使用して構成されます。Each activity is configured with a set of required or optional properties. これらは、アクティビティが他のアクティビティに接続する方法、またはアクティビティがアクションを実行する方法を定義します。These define how the activity connects to other activities or how the activity performs its actions. 活動が runbook ウィンドウに配置されている場合は、そのプロパティを表示または変更できます。When an activity has been placed in the runbook window, you can view or modify its properties.

注意

プロパティには値が必要です。それ以外の場合、プロパティはアクティビティに渡されません。The property needs to have a value, otherwise the property will not be passed to the activity. 空の文字列または空白は、有効な値とは見なされません。An empty string or spaces are not considered valid value. たとえば、GetMailbox アクティビティにはプロパティ Id があります。e.g. GetMailbox activity has a property Identity. このプロパティ Id の値に "" または "" が渡された場合、Identity プロパティは省略されます。If the value for this property Identity is passed "" or " ", then the Identity property will be omitted.

アクティビティのプロパティを表示および構成するにはTo view and configure the properties for an activity

  1. アクティビティをダブルクリックします。Double-click the activity. または、アクティビティを右クリックし、[ プロパティ] をクリックします。Alternatively, you can right-click the activity, and then click Properties.
  2. 必要に応じて、アクティビティのプロパティを表示および構成します。View and configure the activity properties as needed.
  3. 構成エントリを保存するには、[ 完了] をクリックします。To save your configuration entries, click Finish.

[アクティビティのプロパティ] ダイアログボックスでは、さまざまなタブを使用して、アクティビティの全般設定および特定の設定にアクセスできます。In the activity properties dialog box, various tabs provide access to general and specific settings for the activity. オブジェクトのプロパティに使用できるタブの数は、アクティビティによって異なります。The number of available tabs for object properties will vary according to the activity.

[全般] タブGeneral tab

[全般] タブには、アクティビティの名前説明のプロパティが表示されます。The General tab contains the Name and Description properties for the activity. 既定では、アクティビティの 名前 はアクティビティの種類と同じであり、 説明 は空白になります。By default, the Name of the activity is the same as its activity type and the Description is blank. これらのプロパティを変更して、より具体的な名前を指定したり、必要に応じて説明を追加したりすることができます。You can modify these properties to provide a more specific name or to add a description as necessary.

[プロパティ] タブProperties tab

[ プロパティ ] タブには、アクティビティに固有のプロパティが表示されます。The Properties tab contains properties that are specific to the activity. この統合パック内のすべての活動の [プロパティ] タブには、"構成名" プロパティがあります。"構成名" プロパティは、Exchange サーバーへの接続を指定するために使用されます。All activities in this integration pack have the Configuration Name property on the Properties tab. The Configuration Name property is used to specify the connection to the Exchange server.

"構成名" プロパティを構成するにはTo configure the Configuration Name property

  1. [名前] フィールドの横にある省略記号ボタン ([. ..]) をクリックします。Click the ellipsis (...) button next to the Name field.

  2. 該当する接続名を選択します。Select the applicable connection name. 一覧に表示される接続は、「 System Center-Orchestrator の Exchange 管理統合パック」で説明されているように構成済みです。Connections displayed in the list have been previously configured as described in Exchange Admin Integration Pack for System Center - Orchestrator.

フィルターの条件Criteria for filters

Getアクティビティでは、フィルターを使用して、runbook を呼び出す値またはアクティビティを取得する値を決定します。The Get activities use filters to determine the values that will invoke a runbook or retrieve activities. 候補の候補のプロパティ値は、条件を満たしているかどうかを判断するために、フィルターの値と比較されます。Property values of potential candidates are compared to the values of the filters to determine if they meet the criteria. フィルター条件を指定するときに、使用可能な比較方法の1つを選択できます。When you specify filter criteria, you can select one of the available methods of comparison. システムでは、各メソッドを使用してフィルターと一致するかどうかを選択できます。The system provides an option to either match or not match the filter using each method. たとえば、メソッドの "do not" バージョンでは、フィルターに一致しない項目が検索されます。For example, the "Does not" version of a method finds items that do not match the filter. すべてのテキストフィルターでは大文字と小文字が区別されます。All text filters are case sensitive.

  • Equals: 項目のプロパティは、フィルターで指定されたテキストまたは数値と一致します。Equals: The property of the item matches the text or number specified in the filter.
  • が次の値と等しくない: 項目のプロパティが、フィルターで指定されたテキストまたは数値と一致しません。Does not equal: The property of the item does not match the text or number specified in the filter.
  • 次の値より小さい: 項目の数値プロパティが、フィルターで指定された数値より小さい値です。Is less than: The numeric property of the item is less than the number specified in the filter.
  • 次の値以下: 項目の数値プロパティがフィルターで指定されている数値以下です。Is less than or equal to: The numeric property of the item is less than or equal to the number specified in the filter.
  • がより大きい: 項目の数値プロパティが、フィルターで指定された数値を超えています。Is greater than: The numeric property of the item is greater than the number specified in the filter.
  • 次の値以上: 項目の数値プロパティがフィルターに指定された数値以上です。Is greater than or equal to: The numeric property of the item is greater than or equal to the number specified in the filter.
  • Contains: 項目のプロパティには、フィルターで指定されたテキストが含まれています。Contains: The property of the item contains the exact text specified in the filter. 一致するテキストを囲む他のテキストを使用できます。There can be other text surrounding the matching text.
  • が含まれていません: 項目のプロパティに、フィルターで指定された正確なテキストが含まれていません。Does not contain: The property of the item does not contain the exact text specified in the filter.
  • 一致パターン: この比較方法では、正規表現を使用して、テキストが一致する必要があるパターンを指定します。Matches pattern: This comparison method uses regular expressions to specify a pattern that the text must match.
  • 次のパターンと一致しません: この比較方法では、正規表現を使用して、テキストが一致しないパターンを指定します。Does not match pattern: This comparison method uses regular expressions to specify a pattern that the text must not match.
  • で始まる: 項目のプロパティは、フィルターで指定された正確なテキストで始まります。Starts with: The property of the item starts with the exact text specified in the filter.
  • の値で終わる: 項目のプロパティは、フィルターで指定された正確なテキストで終了します。Ends with: The property of the item ends with the exact text specified in the filter.

[実行の動作] タブThe Run Behavior tab

[ 実行の動作 ] タブには、活動が複数値の公開データを処理する方法を決定するプロパティが含まれます。また、アクティビティが失敗したり長時間実行されたりした場合に送信される通知を指定できます。The Run Behavior tab contains the properties that determine how the activity handles multi-value published data and which notifications will be sent if the activity fails or runs for an excessive period of time.

公開データの複数の値Multiple values in published data

Getアクティビティは、別のアクティビティまたは外部ソースから情報を取得し、公開されたデータ内の1つ以上の値を返すことができます。The Get activities retrieve information from another activity or outside source and can then return one or more values in the published data. たとえば、 メールボックスの取得 活動からのデータ出力は、既存のメールボックスの詳細になります。For example, the data output from the Get Mailbox activity could be the details of an existing mailbox.

既定では、 Get アクティビティのデータは複数の個別の出力として渡されます。By default, the data from the Get activity will be passed on as multiple individual outputs. これらの複数の出力は、出力内の項目と同じ回数だけ、次に指定されたアクティビティを呼び出します。These multiple outputs will invoke the next prescribed activity as many times as there are items in the output. また、アクティビティに対して1つの結合された出力を要求するには、 フラット 化オプションを有効にすることもできます。Alternatively, to request a single combined output for the activity, you can enable the Flatten option. フラット化オプションを有効にする場合は、次のように出力形式を指定する必要があります。When you enable the Flatten option, you must specify the output format:

  • 改行を使用して区切ります。Separate with line breaks. 各項目は新しい行にあります。Each item is on a new line. この形式は、人間が判読できるテキストファイルを作成する場合に便利です。This format is useful for creating human-readable text files.
  • と区別します。Separate with. 各項目は、選択した1つ以上の文字で区切られます。Each item is separated by one or more characters of your choice.
  • CSV 形式を使用します。Use CSV format. すべての項目は CSV (コンマ区切り値) 形式です。All items are in CSV (comma-separated value) format. この形式は、スプレッドシートまたはその他のアプリケーションにデータをインポートする場合に便利です。This format is useful for importing data into spreadsheets or other applications.

Getアクティビティを実行するたびに、新しいデータセットが生成されます。The Get activity will produce a new set of data every time it runs. フラット化機能は、同じアクティビティの複数のインスタンスにわたってデータを平坦化するものではありません。The Flatten feature does not flatten data across multiple instances of the same activity.

タイムアウトと失敗のイベント通知Timeout and failure event notifications

一部のアクティビティは、完了までに限られた時間だけかかることが予想されます。Some activities are expected to take only a limited amount of time to complete. 予想される時間内に完了しなかった場合は、停止しているか、完了を妨げる別の問題が発生している可能性があります。If they do not complete within an expected timeframe, they may be stalled or there may be another issue preventing completion. 操作が完了するまでの待機時間を秒数で定義できます。You can define the number of seconds to wait for completion of the action. アクティビティの処理がこのタイムアウトしきい値を超えると、プラットフォームイベントが送信され、問題が報告されます。If the processing of the activity exceeds this timeout threshold, a platform event will be sent and the issue will be reported. 活動がエラーを返した場合にプラットフォーム イベントを生成するかどうかも選択できます。You can also choose whether to generate a platform event if the activity returns a failure.

アクティビティの実行時間が指定した時間を超えた場合、または実行に失敗した場合に通知されるようにするにはTo be notified when the activity takes longer than a specified time to run or fails to run

  1. [ イベント通知 ] ボックスに、通知が生成されるまでの実行時間を 秒数 で入力します。In the Event Notifications box, enter the number of seconds of run time before a notification is generated.

  2. 実行 に失敗した場合 に実行失敗の通知を生成するには、[レポート] を選択します。Select Report if activity fails to run to generate run failure notifications.

公開データPublished data

公開データは、アクティビティのアクションの結果として生成されるデータです。Published data is the data produced as a result of the actions of an activity. このデータは、runbook ごとに一意の内部データバスに発行されます。This data is published to an internal data bus that is unique for each runbook. 公開データは、作業用 runbook の基盤です。Published data is the foundation of a working runbook. Runbook 内の後続のアクティビティは、このデータをサブスクライブして、そのデータを構成で使用できます。Subsequent activities in the runbook can subscribe to this data and use it in their configuration. リンク条件では、この情報を使用して、runbook に意思決定機能を追加することもできます。Link conditions also use this information to add decision-making capabilities to runbooks.

活動は、runbook の前にリンクされているアクティビティからのデータのみをサブスクライブできます。An activity can subscribe only to data from the activities that are linked before it in the runbook. 公開データを使用して、アクティビティに必要なプロパティ値を自動的に設定できます。You can use published data to automatically populate the property values needed by activities.

公開データを使用するにはTo use published data

  1. [プロパティ値] ボックスを右クリックし、[ サブスクライブ] をクリックして、[ 公開データ] をクリックします。Right-click the property value box, click Subscribe, and then click Published Data.
  2. [ アクティビティ ] ドロップダウンボックスをクリックし、データの取得元となるアクティビティを選択します。Click the Activity drop-down box and select the activity from which you want to obtain the data. すべての runbook に共通するその他のデータ要素を表示するには、[ 共通の公開データを表示する] を選択します。To view additional data elements common to all runbooks, select Show Common Published Data.
  3. 使用する公開データ要素をクリックし、[ OK] をクリックします。Click the published data element that you want to use, and then click OK.

各アクティビティによって発行されたデータ要素の一覧については、「特定のアクティビティ」トピックの「 公開データ 」テーブルを参照してください。For a list of the data elements published by each activity, see the Published Data table in the specific activity topic. 共通の公開データ項目の詳細については、「 共通の公開データ」を参照してください。For information about the common published data items, see Common Published Data.

ActivitiesActivities

この統合パックは、 Exchange 管理 カテゴリを Runbook Designer の [ アクティビティ ] ウィンドウに追加します。This integration pack adds the Exchange Admin category to the Activity pane in the Runbook Designer. このカテゴリには、次のアクティビティが含まれます。This category contains the following activities:

メールボックス の作成移動要求 の作成リモートメールボックスの作成 (ハイブリッド) メールボックス を無効にするリモートメールボックスを無効にする (ハイブリッド) メールボックス を有効にするリモートメールボックスを有効にする (ハイブリッド) メールボックス の取得移動要求 の取得移動要求の統計情報 の取得リモートメールボックスを取得する (ハイブリッド) メールボックス の削除リモートメールボックスの削除 (ハイブリッド) Exchange PowerShell コマンド の実行メールボックス の更新移動要求 の更新リモートメールボックスの更新 (ハイブリッド)Create Mailbox Create Move Request Create Remote Mailbox (Hybrid) Disable Mailbox Disable Remote Mailbox (Hybrid) Enable Mailbox Enable Remote Mailbox (Hybrid) Get Mailbox Get Move Request Get Move Request Statistics Get Remote Mailbox (Hybrid) Remove Mailbox Remove Remote Mailbox (Hybrid) Run Exchange PowerShell Command Update Mailbox Update Move Request Update Remote Mailbox (Hybrid)