> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/automation/runbooks/runbook-references/user/general/reprovision-windows365.md). # Reprovision Windows365 Reprovision the Windows 365 Cloud PC of this user ### Description Reprovisions the existing Windows 365 Cloud PC of this user. The Cloud PC is rebuilt from scratch with the same license, so everything stored on it is lost; the user keeps the assignment. Optionally the user gets an email when the reprovisioning starts. ### Offer the license groups as a dropdown The license group is a text field by default. Offer the license groups of your tenant as a dropdown via runbook customization: ```json "rjgit-user_general_reprovision-windows365": { "Parameters": { "licWin365GroupName": { "SelectSimple": { "lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB": "lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB", "lic - Windows 365 Enterprise - 2 vCPU 4 GB 256 GB": "lic - Windows 365 Enterprise - 2 vCPU 4 GB 256 GB" } } } } ``` For more information on how to customize runbooks, please refer to the [Runbook Customization Guide](https://docs.realmjoin.com/automation/runbooks/runbook-customization). ### Location User → General → Reprovision Windows365 **Full Runbook name** rjgit-user\_general\_reprovision-windows365 ### Details | Property | Value | | ---------------- | ----------------------------------- | | Version | 1.0.1 | | Required modules | RealmJoin.RunbookHelper (>= 0.8.10) | | Schedulable | no | ### Permissions #### Application permissions * **Type**: Microsoft Graph * GroupMember.ReadWrite.All * *Reads the license group members to confirm the user holds the Windows 365 license* * Group.ReadWrite.All * *Finds the license group by display name and reads its assigned licenses* * Directory.Read.All * *Reads /subscribedSkus to map the group's SKU to service plans and match the Cloud PC* * CloudPC.ReadWrite.All * *Lists the user's Cloud PCs and triggers the reprovision action* * User.Read.All * *Resolves the user by UPN and checks mailbox presence before mailing* * Mail.Send *(optional — feature: Email report)* * *Notifies the user via /users/{from}/sendMail when sendMailWhenReprovisioning is enabled* ### Parameters #### UserName User principal name of the user the runbook acts on. Set by the portal from the selected user. | Property | Value | | ---------------- | -------------------------------------- | | Required | true | | Default Value | | | Type | String | | Hidden in portal | yes (preset via runbook customization) | #### licWin365GroupName License group of the Cloud PC to reprovision. Type the group name, or pick it when your runbook customization offers a list. | Property | Value | | ------------------- | ------------------------------------------------- | | Required | true | | Default Value | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB | | Type | String | | Portal display name | Windows 365 license of the Cloud PC | #### sendMailWhenReprovisioning Sends the user an email as soon as the reprovisioning has begun. | Property | Value | | ------------------- | ------------------------------------------- | | Required | false | | Default Value | False | | Type | Boolean | | Portal display name | Notify the user when reprovisioning starts? | **Portal options** | Portal option | Value | | -------------------- | ----- | | Do not send an email | false | | Send an email | true | #### fromMailAddress Mailbox the notification email is sent from. | Property | Value | | ------------------- | --------------------- | | Required | false | | Default Value | | | Type | String | | Portal display name | Sender mailbox | #### customizeMail Replaces the standard notification text with your own message. | Property | Value | | ------------------- | --------------------------------- | | Required | false | | Default Value | False | | Type | Boolean | | Portal display name | Customize the notification email? | **Portal options** | Portal option | Value | | ---------------------- | ----- | | Use the standard email | false | | Use a custom message | true | #### customMailMessage Text of the notification email. | Property | Value | | ------------------- | ------------------------------------------------------- | | Required | false | | Default Value | Insert Custom Message here. (Capped at 3000 characters) | | Type | String | | Portal display name | Custom message | [Back to Runbook Reference overview](/automation/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.realmjoin.com/automation/runbooks/runbook-references/user/general/reprovision-windows365.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.