Compartilhar via

Operações de recursos de DSC

O DSC define um conjunto de operações que os recursos podem implementar. A DSC invoca as operações para usar recursos para tarefas diferentes. Nem todo recurso implementa todas as operações.

As operações gerais para gerenciar o estado do sistema são Get, Test e Set.

O restante deste documento descreve as operações de recursos disponíveis.

Obter operação

A operação Get retorna o estado real de uma instância de recurso específica no sistema.

Essa operação só está disponível para recursos que têm o recurso get.

A DSC invoca a operação Get quando você usa os seguintes comandos:

  • dsc resource get para retornar o estado real de uma instância de recurso.
  • dsc config get para retornar o estado real de cada instância em um documento de configuração.

Operação de teste

A operação de teste compara o estado real de uma instância de recurso específica no sistema com um estado desejado especificado. O resultado indica não apenas se a instância está no estado desejado, mas também como o estado real difere do estado desejado.

Se um recurso não tiver a funcionalidade de teste, a DSC testará sinteticamente o recurso.

O DSC invoca a operação de teste quando você usa os seguintes comandos:

  • dsc resource test para testar o estado desejado de uma instância de recurso específica.
  • dsc config test para testar o estado desejado de cada instância em um documento de configuração.

Definir operação

A operação Set impõe o estado desejado de uma instância de recurso em um sistema. O resultado indica como o recurso modificou o sistema.

Essa operação só está disponível para recursos com o recurso definido.

A DSC invoca a operação Set quando você usa os seguintes comandos:

  • dsc resource set para impor o estado desejado de uma instância de recurso específica.
  • dsc config get para impor o estado desejado definido por um documento de configuração.

Operação de exclusão

A operação Delete remove uma instância de recurso de um sistema. A operação não retorna nenhuma saída.

Essa operação só está disponível para recursos com o recurso de exclusão.

A DSC invoca a operação Delete quando você usa os seguintes comandos:

  • dsc resource delete para remover uma instância de recurso específica.

Operação de exportação

A operação Export recupera o estado real de cada instância do recurso em um sistema. O resultado é um documento de configuração que inclui as instâncias exportadas.

Essa operação só está disponível para recursos com o recurso de exportação.

O DSC invoca a operação Export quando você usa os seguintes comandos:

  • dsc resource export para retornar um documento de configuração que enumera o estado real de cada instância de um recurso específico.
  • dsc config export para retornar um documento de configuração que enumera o estado real de cada instância em um documento de configuração.
  • dsc resource get com a --all opção de retornar o estado real para cada instância de um recurso específico como uma matriz de resultados da operação Get .

Operação de lista

A operação List recupera os recursos adaptados disponíveis para um recurso específico do adaptador DSC.

Essa operação só está disponível para recursos do adaptador.

Validar operação

A operação Validate indica se uma instância do recurso está definida de forma válida. Os recursos de comando usam seu esquema de instância de recurso para validação. Os recursos do adaptador implementam a operação Validate para permitir que a DSC valide recursos adaptados, que podem não ter um esquema JSON definido.

A DSC invoca a operação Validate em recursos do adaptador ao validar instâncias de recursos adaptados em um documento de configuração ou quando você usa os dsc resource comandos para chamar diretamente um recurso adaptado.

Operação de resolução

A operação Resolver processa uma instância de recurso do importador para retornar um documento de configuração.

Essa operação só está disponível para recursos com o recurso de resolução. Essa operação é útil principalmente para recursos do importador.

Consulte também