.. _ms-subscriber-staging:


.. model: relation/MicrosoftSubscriberQasStaging


User staging
--------------

.. _24.2-PB1|EKB-22376:


.. tip:: 

   :ref:`use-action-search-to-navigate-automate`



Overview 
............ 

When onboarding Microsoft users into Automate, unlicensed Microsoft 365 users are synced 
in to Automate from the Microsoft Teams cloud portal. 

It is possible to license Microsoft users from within Automate. You could use Quick User 
to apply a user's MS Teams configuration and to license the user in a single operation. Since 
there is a dependency on the Microsoft cloud to sync the changes once the user is licensed, 
Automate places the user in a staging queue while it waits for the Microsoft cloud process to complete. 


.. rubric:: Related Topics

*
  .. raw:: latex

     Microsoft Users in the Core Feature Guide

  .. raw:: html

     <a href="ms-subscribers.html">Microsoft Users</a>

*
  .. raw:: latex

     Microsoft Quick User in the Core Feature Guide

  .. raw:: html

     <a href="qas-for-ms-users.html">Microsoft Quick User</a>

*
  .. raw:: latex

     Site Defaults in the Core Feature Guide

  .. raw:: html

     <a href="site-defaults.html">Site Defaults</a>




Scheduled staging sync 
........................

A scheduled staging sync and workflow can be enabled. This workflow removes the user from staging (unstage), 
re-runs the Microsoft Quick User workflow, updates the Microsoft Teams user with 
their correct provisioning details, provisions the user in Automate, and flags their 
number as used.

The staging schedule sync is disabled by default on install. When enabled, the default is for the 
staging schedule to run every 4 hours.

You can enable the staging schedule sync (``ScheduleMSTeamsOnlineTargetUserSync``) in Automate via 
the **Sync Scheduling** page (select **Active**), where you can also change the execution schedule 
(default is every 4 hours). 


Unstage MS users 
...................

If the Microsoft Teams cloud portal takes too long to create the Microsoft Teams user and you don't 
want to wait for the scheduled workflow to execute (if its enabled), you can perform an unstage action on one or 
more selected users on the **User Staging** page to immediately execute the workflow for the 
selected users. 


.. rubric:: To unstage one or more MS users 

1. In the Admin Portal, use the **Action** search to go to the **Microsoft Users in Staging** page. 
2. Select one or more users to remove from staging. 
3. Click **Unstage immediate**.