Skip to main content

Export-CloudPCProvisioningPolicy

Exports a Windows 365 Cloud PC provisioning policy as reusable JSON.

Description

Exports the create-safe provisioning policy body and assignment targets for a policy returned by Microsoft Graph beta. Read-only Graph fields are not placed in CreateBody, so the JSON can be passed to New-CloudPCProvisioningPolicy.

Assignments are exported separately because Graph creates the provisioning policy first, then assigns it with /provisioningPolicies/{id}/assign.

Syntax


Export-CloudPCProvisioningPolicy -Id <string> [-Path <string>] [-Force] [<CommonParameters>]

Export-CloudPCProvisioningPolicy -Policy <Object> [-Path <string>] [-Force] [<CommonParameters>]

Parameters

NameTypeRequiredAliasesDescription
ForceSwitchParameterNoOverwrite Path when it already exists.
IdStringYesProvisioningPolicyIdThe provisioning policy ID to export.
PathStringNoOptional JSON file path to write. If omitted, the export object is emitted.
PolicyObjectYesA WindowsCloudPC.ProvisioningPolicy object returned by Get-CloudPCProvisioningPolicy.

Graph endpoints

Endpoint details are described in the source and examples.

Example 1

Get-CloudPCProvisioningPolicy -Id '<policy-id>' |
Export-CloudPCProvisioningPolicy -Path .\policy.json

Example 2

Export-CloudPCProvisioningPolicy -Id '<policy-id>' |
New-CloudPCProvisioningPolicy -DisplayName 'Copy of source policy' -WhatIf

Source

View Export-CloudPCProvisioningPolicy.ps1 on GitHub