Comece com a configuração do estado desejado da Microsoft v3.0.0

Instalando DSC

Para começar, siga estas etapas para instalar o DSC em seu sistema:

No Windows, você pode instalar o DSC da Microsoft Store usando winget. Instalando da Loja ou usando wingetvocê obtém atualizações automáticas para DSC.

winget search DesiredStateConfiguration
winget install --id  --source msstore

No Linux e no macOS, você pode instalar o DSC seguindo as seguintes etapas:

1. Baixe a versão mais recente do PowerShell/DSC repositório.
2. Expanda o arquivo de lançamento.
3. Adicione a pasta que contém o conteúdo do arquivo expandido ao seu PATH variável de ambiente.

Introdução ao comando DSC

O dsc O comando opera em um documento de configuração ou invoca recursos específicos para gerenciar configurações.

Execute o seguinte comando para exibir o dsc comando ajuda:

dsc --help

Apply configuration or invoke specific DSC resources

Usage: dsc.exe (OPTIONS) 

Commands:
  completer  Generate a shell completion script
  config     Apply a configuration document
  resource   Invoke a specific DSC resource
  schema     Get the JSON schema for a DSC type
  help       Print this message or the help of the given subcommand(s)

Options:
  -l, --trace-level     Trace level to use (possible values: error, warn, info, debug, trace)
  -t, --trace-format   Trace format to use (default: default) (possible values: default, plaintext, json)
  -h, --help                         Print help
  -V, --version                      Print version

Use o comando para obter informações de versão.

dsc --version

dsc 3.0.0

Para saber mais, consulte o dsc documentação de referência de comando.

Acesse recursos DSC com dsc resource

O dsc resource O comando exibe ou invoca um recurso DSC específico. O dsc resource O comando contém subcomandos para listar recursos DSC e invocá-los diretamente.

Use o comando a seguir para exibir uma lista de recursos DSC instalados.

dsc resource list

Type                                        Kind      Version  Caps      RequireAdapter  Description
----------------------------------------------------------------------------------------------------
Microsoft.DSC.Transitional/RunCommandOnSet  Resource  0.1.0    gs------                  Takes a si…
Microsoft.DSC/Assertion                     Group     0.1.0    gs--t---                  `test` wil…
Microsoft.DSC/Group                         Group     0.1.0    gs--t---                  All resour…
Microsoft.DSC/PowerShell                    Adapter   0.1.0    gs--t-e-                  Resource a…
Microsoft.Windows/RebootPending             Resource  0.1.0    g-------                  Returns in…
Microsoft.Windows/Registry                  Resource  0.1.0    gs-w-d--                  Manage Win…
Microsoft.Windows/WMI                       Adapter   0.1.0    g-------                  Resource a…
Microsoft.Windows/WindowsPowerShell         Adapter   0.1.0    gs--t---                  Resource a…

Quando o comando inclui a opção de adaptador, dsc verifica se há adaptadores de recursos com um nome correspondente. Os recursos clássicos do PowerShell fazem parte do Microsoft.Windows/WindowsPowerShell adaptador.

dsc resource list --adapter Microsoft.Windows/WindowsPowerShell

Partial listing

Type                                                   Kind      Version  Caps      RequireAdapter
----------------------------------------------------------------------------------------------------
PSDesiredStateConfiguration/Archive                    Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/Environment                Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/File                       Resource  1.0.0    gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/Group                      Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/GroupSet                   Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/Log                        Resource  1.1      gs--t---  Microsoft.Windo…

Para saber mais, consulte o dsc documentação de referência do comando de recursos.

Gerenciar uma configuração básica

O dsc config O comando inclui subcomandos para gerenciar as instâncias de recursos definidas em um documento de configuração DSC.

O seguinte documento de configuração YAML chama o recurso clássico do PowerShell WindowsFeature
do PSDesiredStateConfiguração módulo para instalar um servidor web Windows (IIS) no Windows Server.

$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
  - name: Use Windows PowerShell resources
    type: Microsoft.Windows/WindowsPowerShell
    properties:
      resources:
        - name: Web server install
          type: PSDesiredStateConfiguration/WindowsFeature
          properties:
            Name: Web-Server
            Ensure: Present

Para definir uma máquina para a configuração, use o dsc config set subcomando. O exemplo a seguir mostra como você pode enviar o documento de configuração para DSCv3 usando o PowerShell:

dsc config get --file ./web.comfig.dsc.yaml

Para saber mais, consulte o dsc config documentação de referência de comando.

Próximas etapas

Saiba mais sobre os aprimoramentos de criação na configuração de estado desejado v3.0.0.

Chamada para ação

Para obter mais informações sobre o DSC v3.0, consulte o Documentação DSCv3. Valorizamos seu feedback. Passe pelo nosso Repositório GitHub e informe-nos sobre quaisquer problemas que você encontrar.

Jason Helmick

Gerente de produto sênior, PowerShell