You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/governance/machine-configuration/how-to/create-policy-definition.md
+27-3Lines changed: 27 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -105,13 +105,19 @@ Parameters of the `New-GuestConfigurationPolicy` cmdlet:
105
105
-**Description**: Policy description.
106
106
-**Parameter**: Policy parameters provided in a hash table.
107
107
-**PolicyVersion**: Policy version.
108
-
-**Path**: Destination path where policy definitions are created.
108
+
-**Path**: Destination path where policy definitions are created. This is NOT a path a local copy of the package.
109
109
-**Platform**: Target platform (Windows/Linux) for machine configuration policy and content
110
110
package.
111
111
-**Mode**: (case sensitive: `ApplyAndMonitor`, `ApplyAndAutoCorrect`, `Audit`) choose if the policy should audit
112
112
or deploy the configuration. The default is `Audit`.
113
113
-**Tag** adds one or more tag filters to the policy definition
114
114
-**Category** sets the category metadata field in the policy definition
115
+
-**LocalContentPath** (Optional) - The path to the local copy of the `.zip` Machine Configuration package file (Required if you are using a User Assigned Managed Identity to provide access to an Azure Storge blob)
116
+
-**ManagedIdentityResourceId** (Optional) - The resourceId of the User Assigned Managed Identity with read access to the Azure Storage blob containing the `.zip` Machine Configuration package file (Required if you are using a User Assigned Managed Identity to provide access to an Azure Storge blob)
117
+
-**`-ExcludeArcMachines`** (Optional) - A flag to exclude Arc machines from the generated Policy definition (Required if you are using a User Assigned Managed Identity to provide access to an Azure Storge blob)
118
+
119
+
> [!IMPORTANT]
120
+
> Please note that, unlike Azure VMs, Arc-connected machines currently do not support User Assigned Managed Identities. As a result, the `-ExcludeArcMachines` flag is required to ensure the exclusion of those machines from the policy definition.
115
121
116
122
For more information about the **Mode** parameter, see the page
117
123
[How to configure remediation options for machine configuration][02].
@@ -132,8 +138,7 @@ $PolicyConfig = @{
132
138
New-GuestConfigurationPolicy @PolicyConfig
133
139
```
134
140
135
-
Create a policy definition that deploys a configuration using a custom configuration package, in a
136
-
specified path:
141
+
Create a policy definition that deploys a configuration using a custom configuration package with a User Assigned Managed Identity:
137
142
138
143
```powershell
139
144
$PolicyConfig2 = @{
@@ -150,6 +155,25 @@ $PolicyConfig2 = @{
150
155
New-GuestConfigurationPolicy @PolicyConfig2
151
156
```
152
157
158
+
Create a policy definition that deploys a custom configuration package using a User Assigned Managed Identity:
0 commit comments