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/virtual-machines/extensions/dsc-overview.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,19 +26,19 @@ The Azure Linux Agent for Azure virtual machines (VM) and the associated extensi
26
26
The primary use for the Azure Desired State Configuration (DSC) extension for Windows PowerShell is to bootstrap a VM to the
27
27
[Azure Automation State Configuration (DSC) service](../../automation/automation-dsc-overview.md). This service provides [benefits](/powershell/dsc/managing-nodes/metaConfig#pull-service) that include ongoing management of the VM configuration and integration with other operational tools, such as Azure Monitor. You can use the extension to register your VMs to the service and gain a flexible solution that works across Azure subscriptions.
28
28
29
-
You can run the Azure DSC extension independently of the Automation DSC service, but this method only pushes a configuration to the VM. No ongoing reporting is available, other than locally in the VM. Before you enable the Azure DSC extension, [choose the DSC version](#dsc-versions) that best supports your configuration and implementation goals.
29
+
You can run the Azure DSC extension independently of the Automation DSC service, but this method only pushes a configuration to the VM. No ongoing reporting is available, other than locally in the VM. Before you enable the Azure DSC extension, [review the available DSC versions](#desired-state-configuration-versions), and choose the version that supports your configuration requirements.
30
30
31
31
This article describes how to use the Azure DSC extension for Automation onboarding, or use it as a tool to assign configurations to VMs with the Azure SDK.
32
32
33
33
## Desired State Configuration versions
34
34
35
35
There are several versions of DSC available for implementation. Before you enable the Azure DSC extension, choose the DSC version that best supports your configuration and business goals.
36
36
37
-
|**DSCversion**| Availability | Description |
37
+
| DSC version | Availability | Description |
38
38
| --- | --- | --- |
39
-
|**DSC 2.0**| General availability |[DSC 2.0](/powershell/azure/dsc/overview?view=dsc-2.0) is supported for use with the Azure Automanage [Machine Configuration](../../governance/machine-configuration/overview.md) feature. The machine configuration feature combines features of the Azure DSC extension handler, Azure Automation State Configuration, and the most commonly requested features from customer feedback. Machine configuration also includes hybrid machine support through [Arc-enabled servers](../../azure-arc/servers/overview.md). |
40
-
|**DSC 1.1**| General availability | If your implementation doesn't use the Azure Automanage machine configuration feature, you should choose DSC 1.1. For more information, see [PSDesiredStateConfiguration v1.1](/powershell/azure/dsc/overview?view=dsc-1.1). |
41
-
|**DSC 3.0**| Public preview |[DSC 3.0 is available in public beta](/powershell/azure/dsc/overview?view=dsc-3.0). This version should be used only with Azure machine configuration, or for nonproduction environments to test migrating away from DSC 1.1. |
39
+
|**DSC 2.0**| General availability |[Desired State Configuration 2.0](/powershell/dsc/overview?view=dsc-2.0&preserve-view=true) is supported for use with the Azure Automanage [Machine Configuration](../../governance/machine-configuration/overview.md) feature. The machine configuration feature combines features of the Azure DSC extension handler, Azure Automation State Configuration, and the most commonly requested features from customer feedback. Machine configuration also includes hybrid machine support through [Arc-enabled servers](../../azure-arc/servers/overview.md). |
40
+
|**DSC 1.1**| General availability | If your implementation doesn't use the Azure Automanage machine configuration feature, you should choose Desired State Configuration 1.1. For more information, see [PSDesiredStateConfiguration v1.1](/powershell/dsc/overview?view=dsc-1.1&preserve-view=true). |
41
+
|**DSC 3.0**| Public preview |[Desired State Configuration 3.0 is available in public beta](/powershell/dsc/overview?view=dsc-3.0&preserve-view=true). This version should be used only with Azure machine configuration, or for nonproduction environments to test migrating away from Desired State Configuration 1.1. |
42
42
43
43
## Prerequisites
44
44
@@ -204,7 +204,7 @@ To set up the Azure DSC extension in the Azure portal, follow these steps:
204
204
205
205
1. Select **Create** at the bottom of the extension information page.
206
206
207
-
1.In the Azure portal, configure the following settings for the Azure DSC extension:
207
+
1.Configure the following settings for the Azure DSC extension:
208
208
209
209
-**Configuration Modules or Script**: This setting is mandatory. (The form isn't updated for the [default configuration script](#default-configuration-script).) Configuration modules and scripts require a .ps1 file that has a configuration script or a .zip file with a .ps1 configuration script at the root. If you use a .zip file, all dependent resources must be included in module folders in the .zip file. You can create the .zip file by using the **Publish-AzureVMDscConfiguration -OutputArchivePath** cmdlet that's included in the Azure PowerShell SDK. The .zip file is uploaded to your user Blob Storage and secured by an SAS token.
0 commit comments