Trabalhar com o histórico de versão da extensão Desired State Configuration do Azure

Observação

Antes de você habilitar a State Configuration da Automação, gostaríamos de informar que uma versão mais recente da DSC agora está em disponibilidade geral, gerenciada por um recurso de Azure Policy chamado configuração de convidado. O serviço de configuração de convidado combina recursos de extensão de DSC, State Configuration da Automação do Azure e os recursos mais solicitados dos comentários dos clientes. A configuração de convidado também inclui suporte a computadores híbridos por meio de servidores habilitados para Arc.

A extensão de VM Azure DSC (Desired State Configuration) é atualizada conforme necessário para dar suporte a aprimoramentos e novas funcionalidades oferecidos pelo Azure, pelo Windows Server e pelo WMF (Windows Management Framework) que inclui o Windows PowerShell.

Este artigo fornece informações sobre cada versão da extensão de VM Azure DSC, os ambientes compatíveis, além de comentários e observações sobre novos recursos ou alterações.

Última versão

Versão 2.83

• Data de lançamento:
  • Fevereiro de 2021
• Suporte a SO:
  • Windows Server 2019
  • Windows Server 2016
  • Windows Server 2012 R2
  • Windows Server 2012
  • Windows Server 2008 R2 SP1
  • Windows Client 7/8.1/10
  • Nano Server
• Suporte a WMF:
  • Windows Management Framework 5.1
  • WMF 5.0 RTM
  • Atualização do WMF 4.0
  • Windows Management Framework 4.0
• Ambiente:
  • Azure
  • Microsoft Azure operado pela 21Vianet
  • Azure Governamental
• Comentários: essa versão inclui uma correção para binários não assinados com a extensão de VM do Windows.

Versão 2.80

• Data de lançamento:
  • 26 de setembro de 2019 (Azure) | 6 de julho de 2020 (Microsoft Azure operado pela 21Vianet) | 20 de julho de 2020 (Azure Governamental)
• Suporte a SO:
  • Windows Server 2019
  • Windows Server 2016
  • Windows Server 2012 R2
  • Windows Server 2012
  • Windows Server 2008 R2 SP1
  • Windows Client 7/8.1/10
  • Nano Server
• Suporte a WMF:
  • Windows Management Framework 5.1
  • WMF 5.0 RTM
  • Atualização do WMF 4.0
  • Windows Management Framework 4.0
• Ambiente:
  • Azure
  • Microsoft Azure operado pela 21Vianet
  • Azure Governamental
• Comentários: não há novos recursos incluídos nesta versão.

Versão 2.76

• Data de lançamento:
  • 09 de maio de 2018 (Azure) | 21 de junho de 2018 (Microsoft Azure operado pela 21Vianet, Azure Governamental)
• Suporte a SO:
  • Windows Server 2016
  • Windows Server 2012 R2
  • Windows Server 2012
  • Windows Server 2008 R2 SP1
  • Windows Client 7/8.1/10
  • Nano Server
• Suporte a WMF:
  • Windows Management Framework 5.1
  • WMF 5.0 RTM
  • Atualização do WMF 4.0
  • Windows Management Framework 4.0
• Ambiente:
  • Azure
  • Microsoft Azure operado pela 21Vianet
  • Azure Governamental
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Melhoria nos metadados de extensão de substatus e outras correções de bugs secundárias.

Versões com suporte

Aviso

As versões 2.4 a 2.13 usam a Versão Prévia Pública do WMF 5.0, cujos certificados de assinatura expiraram em agosto de 2016. Para obter mais informações sobre esse problema, confira o artigo de blog a seguir.

Versão 2.75

• Data de lançamento: 5 de março de 2018
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:

  • Após a imposição do TLS 1.2 pelo GitHub, não é possível integrar uma VM ao State Configuration da Automação do Azure usando modelos "Faça você mesmo" do Resource Manager disponíveis no Azure Marketplace, nem usar a extensão DSC para recuperar configurações hospedadas no GitHub. Um erro semelhante ao seguinte é retornado durante a implantação da extensão:

    {
        "code": "DeploymentFailed",
        "message": "At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-debug for usage details.",
        "details": [{
            "code": "Conflict",
            "message": "{
                \"status\": \"Failed\",
                \"error\": {
                    \"code\": \"ResourceDeploymentFailure\",
                    \"message\": \"The resource operation completed with terminal provisioning state 'Failed'.\",
                    \"details\": [ {
                        \"code\": \"VMExtensionProvisioningError\",
                        \"message\": \"VM has reported a failure when processing extension 'Microsoft.Powershell.DSC'.
                        Error message: \\\"The DSC Extension failed to execute: Error downloading
                        https://github.com/Azure/azure-quickstart-templates/raw/master/dsc-extension-azure-automation-pullserver/UpdateLCMforAAPull.zip
                        after 29 attempts: The request was aborted: Could not create SSL/TLS secure channel..\\nMore information about the failure can
                        be found in the logs located under 'C:\\\\WindowsAzure\\\\Logs\\\\Plugins\\\\Microsoft.Powershell.DSC\\\\2.74.0.0' on the VM.\\\".\"
                    } ]
                }
            }"
        }]
    }
    

  • A nova versão da extensão, o TLS 1.2 agora é imposto. Ao implantar a extensão, se você já tiver especificado AutoUpgradeMinorVersion = true no modelo do Resource Manager a extensão será atualizada automaticamente para 2.75. Para obter atualizações manuais, especifique TypeHandlerVersion = 2.75 em seu modelo do Resource Manager.

Versão 2.70 – 2.72

• Data de lançamento: 13 de novembro de 2017
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Correções de bugs e aprimoramentos que simplificam o uso da State Configuration da Automação do Azure no portal e com um modelo do Resource Manager. Para obter mais informações, confira Script de Configuração Padrão na documentação da extensão DSC.

Versão 2.26

• Data de lançamento: 9 de junho de 2017
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Melhorias de telemetria.

Versão 2.25

• Data de lançamento: 2 de junho de 2017
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Várias correções de bug e outras pequenas melhorias foram adicionadas.

Versão 2.24

• Data de lançamento: 13 de abril de 2017
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Expõe a ID do Agente do DSC e a UUID da VM como metadados de extensão. Outros aprimoramentos secundários foram adicionados.

Versão 2.23

• Data de lançamento: 15 de março de 2017
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Foram adicionadas correções de bug e outros aprimoramentos.

Versão 2.22

• Data de lançamento: 8 de fevereiro de 2017
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server
• Suporte a WMF: WMF 5.1, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.1 (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • Agora a extensão DSC dá suporte a WMF 5.1.
  • Outros aprimoramentos secundários foram adicionados.

Versão 2.21

• Data de lançamento: 2 de dezembro de 2016
• Suporte a SO: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1, Nano Server
• Suporte a WMF: WMF 5.1 Versão Prévia, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização). Para o Nano Server, a função de DSC é instalada na VM.
• Novos recursos:
  • A extensão DSC agora está disponível no Nano Server. Esta versão contém principalmente alterações de código para executar a extensão no Nano Server.
  • Outros aprimoramentos secundários foram adicionados.

Versão 2.20

• Data de lançamento: 2 de agosto de 2016
• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1
• Suporte a WMF: WMF 5.1 Versão Prévia, WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).
• Novos recursos:
  • Suporte para o WMF 5.1 Versão Prévia. Quando publicada pela primeira vez, esta versão era uma atualização opcional e era preciso especificar Wmfversion = '5.1PP' em modelos do Resource Manager para instalar a versão prévia do WMF 5.1. Wmfversion = 'latest' ainda instala o WMF 5.0 RTM. Para obter mais informações sobre o WMF 5.1 Versão Prévia, consulte este blog.
  • Outros aprimoramentos e correções secundários foram adicionados.

Versão 2.19

• Data de lançamento: 3 de junho de 2016
• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1
• Suporte a WMF: WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure, Microsoft Azure operado pela 21Vianet, Azure Governamental
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).
• Novos recursos:
  • A extensão DSC agora está disponível no Microsoft Azure operado pela 21Vianet. Esta versão contém correções para executar a extensão no Microsoft Azure operado pela 21Vianet.

Versão 2.18

• Data de lançamento: 3 de junho de 2016
• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1
• Suporte a WMF: WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).
• Novos recursos:
  • Torne a telemetria sem bloqueio quando ocorre um erro durante o download do hotfix de telemetria (problema conhecido do DNS do Azure) ou durante a instalação.
  • Corrija o problema intermitente em que a extensão interrompe o processamento da configuração após uma reinicialização. Isso fazia com que a extensão DSC permanecesse no estado "em transição".
  • Outros aprimoramentos e correções secundários foram adicionados.

Versão 2.17

• Data de lançamento: 26 de abril de 2016

• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1

• Suporte a WMF: WMF 5.0 RTM, Atualização do WMF 4.0, WMF 4.0

• Ambiente: Azure

• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).

• Novos recursos:

  • Suporte para a Atualização do WMF 4.0. Para obter mais informações sobre o WMF 4.0 Update, consulte este blog.
  • Lógica de repetição em erros que ocorrem durante a instalação da extensão DSC ou durante a aplicação de uma configuração DSC após a instalação da extensão. Como parte dessa alteração, a extensão tentará novamente realizar a instalação se uma instalação anterior tiver falhado ou tentará aplicar novamente uma configuração de DSC que falhou anteriormente, no máximo três vezes, até que ela atinja o estado de conclusão (Êxito/Erro) ou que uma nova solicitação chegue. Se a extensão falhar devido a configurações de usuário/entrada do usuário inválidas, ela não tentará novamente. Nesse caso, a extensão deve ser invocada novamente com uma nova solicitação e configurações do usuário corretas.

  Observação

  A extensão DSC depende do agente de VM do Azure para as novas tentativas. O Agente de VM do Azure invoca a extensão com a última solicitação com falha até ela atingir um estado de êxito ou de erro.

Versão 2.16

• Data de lançamento: 21 de abril de 2016
• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1
• Suporte a WMF: WMF 5.0 RTM, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).
• Novos recursos:
  • Melhoria no tratamento de erros e outras correções de bugs secundárias.
  • Nova propriedade nas configurações da extensão DSC. ForcePullAndApply em AdvancedOptions será adicionado para habilitar a extensão DSC a aplicar configurações DSC quando o modo de atualização for Pull (em vez do modo padrão, Push). Para obter mais informações sobre as configurações da extensão DSC, confira este blog.

Versão 2.15

• Data de lançamento: 14 de março de 2016
• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1
• Suporte a WMF: WMF 5.0 RTM, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).
• Novos recursos:
  • Na versão da extensão 2.14, foram incluídas alterações para instalar o WMF RTM. Durante a atualização de versão da extensão 2.13.2.0 para 2.14.0.0, observe que alguns cmdlets de DSC falham ou a sua configuração falha com o erro "Nenhuma instância encontrada com os valores de propriedade fornecidos". Para ibter mais informações, consulte as notas de versão do DSC. As soluções alternativas para esses problemas foram adicionadas na versão 2.15.
  • Se já tiver instalado a versão 2.14 e estiver encontrando um dos dois problemas acima, você precisará executar essas etapas manualmente. Em uma sessão do PowerShell com privilégios elevados, execute os seguintes comandos:
    • Remove-Item -Path $env:SystemRoot\system32\Configuration\DSCEngineCache.mof
    • mofcomp $env:windir\system32\wbem\DscCoreConfProv.mof

Versão 2.14

• Data de lançamento: 25 de fevereiro de 2016
• Suporte a SO: Windows Server 2016 Technical Preview, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 SP1
• Suporte a WMF: WMF 5.0 RTM, WMF 4.0
• Ambiente: Azure
• Comentários: essa versão usa DSC conforme incluído no Windows Server 2016 Technical Preview; para outros sistemas operacionais Windows, ela instala o Windows Management Framework 5.0 RTM (a instalação do WMF requer uma reinicialização).
• Novos recursos:
  • Usa o WMF RTM.
  • Habilita a coleta de dados para melhorar a qualidade da extensão DSC. Para obter mais informações, confira este artigo de blog.
  • Fornece um formato de configurações atualizadas para a extensão em um modelo do Resource Manager. Para obter mais informações, confira este artigo de blog.
  • Correções de bug e outros aprimoramentos.

Próximas etapas

• Para obter mais informações sobre o DSC do PowerShell, consulte o Centro de documentação do PowerShell.
• Examine o modelo do Resource Manager para a extensão de DSC.
• Para mais funcionalidades e recursos que você pode gerenciar com a DSC do PowerShell, navegue na galeria do PowerShell.
• Para obter detalhes sobre como passar parâmetros confidenciais em configurações, consulte Gerenciar credenciais com segurança com o manipulador de extensão de DSC.