Extending Subscriptions and Onboarding Exchange Objects

Extend every Hosted Exchange 2016 subscription with Hosted Exchange application resources, and onboard (or register in the APSC) its Exchange objects by performing the followings steps:

  1. Prepare a list of all Hosted Exchange 2016 subscriptions (write down their identifiers). To prepare this list, you can use the information provided at Services > Applications > the APS Connectors tab > ExchangeApplication > the Instances tab > the Hosted Exchange application instance > the Exchange tab > the Switch to Exchange Application subtab (look for subscriptions where Status is Not Started).
  2. Extend every subscription with Hosted Exchange application resources by running the following command:

    python switch-to-hosted-exchange-app.py extend-subscription --rt-map PATH_TO_RESOURCE_MAP_FILE --subscriptions SUBSCRIPTION_IDENTIFIERS

    In the command, you must specify the following:

    • PATH_TO_RESOURCE_MAP_FILE: The full path to the resource map file that you prepared in the Creating a Resource Map File step.
    • SUBSCRIPTION_IDENTIFIERS: The identifiers of the subscriptions that you need to extend. Identifiers must be separated with spaces.

    Note: You can use the --precheck option to check that Hosted Exchange subscriptions can be successfully processed.

  3. Onboard the Exchange objects of every subscription by running the following command:

    python switch-to-hosted-exchange-app.py switch-app --subscriptions SUBSCRIPTION_IDENTIFIERS

    In the command, you must specify the following:

    • SUBSCRIPTION_IDENTIFIERS: The identifiers of the subscriptions whose Exchange objects you need to onboard. Identifiers must be separated with spaces.

    Note: You can use the --precheck option to check that Hosted Exchange subscriptions can be successfully processed.

  4. Wait for "Execute operation 'propagation'" tasks to complete. Note that if a task fails, you can find the reason in the task manager (Operations > Tasks) in the task's log.

After you perform the steps above, all Hosted Exchange 2016 subscriptions will be extended with Hosted Exchange application resources, as defined in the resource map file that you prepared. All Exchange objects, such as mailboxes, distribution lists, and so on, will be onboarded.

Notes:

1. While the steps above are performed (in particular step 4, which may take a long time depending on the number of Exchange objects needing to be onboarded), end users of the affected subscriptions will not be able to manage their Hosted Exchange services through the control panel. We recommend that you split the list of all Hosted Exchange subscriptions into small groups and perform the steps above for every group, not for all Hosted Exchange subscriptions at once.

2. Instead of using --subscriptions SUBSCRIPTION_IDENTIFIERS, you can use --subscriptions-file PATH_TO_FILE, where PATH_TO_FILE is the path to a file containing the identifiers of the subscriptions that you need to process (identifiers must be separated either with spaces or newline characters).