Compartilhar via


Configuração de Estado Desejado 2.0

Com a versão do PowerShell 7.2, o módulo PSDesiredStateConfiguration não está mais incluído no pacote do PowerShell. Separar o DSC em seu próprio módulo nos permite investir e desenvolver DSC independente do PowerShell e reduz o tamanho do pacote do PowerShell. Os usuários do DSC podem aproveitar o benefício de atualizar o DSC sem a necessidade de atualizar o PowerShell, acelerando o tempo para a implantação de novos recursos de DSC. Os usuários que desejam continuar usando o DSC v2 podem baixar PSDesiredStateConfiguration 2.0.7 da Galeria do PowerShell.

Os usuários que trabalham com ambientes que não são do Windows podem esperar recursos multiplataforma no DSC v3. Para obter mais informações sobre o futuro do DSC, consulte o blog da equipe do PowerShell.

Para instalar PSDesiredStateConfiguration 2.0.7 da Galeria do PowerShell:

Install-Module -Name PSDesiredStateConfiguration -Repository PSGallery -MaximumVersion 2.99

Importante

Certifique-se de incluir o parâmetro MaximumVersion ou você pode instalar a versão 3 (ou superior) de PSDesireStateConfiguration que contém diferenças significativas.

Caso de Uso para DSC 2.0

O DSC 2.0 tem suporte para uso com de configuração de computador do Azure. Outros cenários, como chamar diretamente recursos DSC com Invoke-DscResource, podem ser funcionais, mas não são o uso principal pretendido desta versão.

Se você não estiver usando a configuração do computador do Azure, deverá usar o DSC 1.1.machine

Alterações do DSC 1.1

Há várias alterações importantes no DSC 2.0.

A única maneira de usar recursos DSC no 2.0 é com o cmdlet Invoke-DscResource ou a configuração do computador do Azure.

Os seguintes cmdlets foram removidos:

  • Disable-DscDebug
  • Enable-DscDebug
  • Get-DscConfiguration
  • Get-DscConfigurationStatus
  • Get-DscLocalConfigurationManager
  • Publish-DscConfiguration
  • Remove-DscConfigurationDocument
  • Restore-DscConfiguration
  • Set-DscLocalConfigurationManager
  • Start-DscConfiguration
  • Stop-DscConfiguration
  • Test-DscConfiguration
  • Update-DscConfiguration

Os seguintes recursos foram removidos:

  • O servidor de pull
  • O LCM (gerenciador de configuração local)

Não há suporte para os seguintes recursos:

  • Configurações de DSC de vários sistemas
  • Dependências entre sistemas (os recursos de DSC WaitFor*)
  • Reinicializando o comportamento para recursos DSC
  • Adicionando parâmetros a blocos de configuração de DSC
  • Usando instruções de controle de fluxo em blocos de configuração de DSC
  • Usando credenciais em blocos de configuração de DSC
  • Usando o parâmetro ConfigurationData com uma configuração de DSC
  • Usando a palavra-chave Node em uma configuração de DSC
  • Usando configurações de DSC compostas (configurações de DSC que aninham outra configuração de DSC dentro delas)

Os recursos de DSC internos foram removidos. O módulo PSDscResources inclui substituições para alguns recursos de DSC removidos. Consulte a tabela a seguir para obter o status dos recursos DSC.

Recurso DSC Estado
Archive Substituído pelo recurso DSC Archive no PSDscResources.
Environment Substituído pelo recurso DSC do ambiente de em PSDscResources.
File Removido. Esse recurso DSC não está disponível no DSC v2 e posterior.
Group Substituído pelo recurso DSC do grupo em PSDscResources.
GroupSet Substituído pelo recurso GroupSet DSC noPSDscResources.
Log Removido. Esse recurso DSC não está disponível no DSC v2 e posterior.
Package Parcialmente substituído pelo recurso MsiPackage DSC no PSDscResources.
ProcessSet Substituído pelo recurso DSC do ProcessSet noPSDscResources.
Registry Substituído pelo recurso DSC do Registro no PSDscResources.
Script Substituído pelo recurso DSC de script no PSDscResources.
Service Substituído pelo recurso DSC do serviço no PSDscResources.
ServiceSet Substituído pelo recurso DSC do ServiceSet noPSDscResources.
User Substituído pelo recurso DSC do usuário no PSDscResources.
WaitForAll Removido. Esse recurso DSC não está disponível no DSC v2 e posterior.
WaitForAny Removido. Esse recurso DSC não está disponível no DSC v2 e posterior.
WaitForSome Removido. Esse recurso DSC não está disponível no DSC v2 e posterior.
WindowsFeature Substituído pelo recurso WindowsFeature DSC noPSDscResources.
WindowsFeatureSet Substituído pelo recurso DSC WindowsFeatureSet em PSDscResources.
WindowsOptionalFeature Substituído pelo recurso WindowsOptionalFeature DSC noPSDscResources.
WindowsOptionalFeatureSet Substituído pelo recurso DSC WindowsOptionalFeatureSet noPSDscResources.
WindowsPackageCab Substituído pelo recurso DSC WindowsPackageCab no PSDscResources.
WindowsProcess Substituído pelo recurso WindowsProcess DSC noPSDscResources.