Partilhar via

Referência do esquema de resultados do conjunto de configurações DSC

Sinopse

A saída do resultado do comando dsc config set.

Metadados

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/outputs/config/set.json
Type:          object

Descrição

A saída do comando dsc config set inclui o estado de cada instância de recurso na configuração antes e depois da operação set e a lista de propriedades que a operação alterou para cada instância.

Propriedades necessárias

A saída sempre inclui estas propriedades:

Propriedades

metadados

Define os retornos DSC de metadados para uma operação de configuração. As propriedades sob a propriedade Microsoft.DSC descrevem o contexto da operação.

Type:     object
Required: true

Microsoft.DSC

Os metadados sob esta propriedade descrevem o contexto da operação geral:

  • versão define a versão do DSC que executou o comando. Esse valor é sempre a versão semântica do comando DSC, como 3.0.0-preview.7.
  • operação define a operação que o DSC aplicou ao documento de configuração: Get, Set, Testou Export.
  • executionType define se o DSC realmente aplicou uma operação à configuração ou se foi executado no modo WhatIf. Esta propriedade é sempre Actual para operações Get, Teste Export. Para operações Set, esse valor é WhatIf quando o DSC é invocado com o argumento --what-if.
  • startDatetime define a data e hora de início da operação DSC como um carimbo de data/hora seguindo o formato definido em RFC3339, seção 5.6 (consulte date-time), como 2024-04-14T08:49:51.395686600-07:00.
  • endDatetime define a data e hora de término da operação DSC como um carimbo de data/hora seguindo o formato definido no RFC3339, seção 5.6 (consulte date-time), como 2024-04-14T08:49:51.395686600-07:00.
  • duração define a duração de uma operação DSC em relação a um documento de configuração ou instância de recurso como uma cadeia de caracteres seguindo o formato definido em ISO8601 ABNF para duration. Por exemplo, PT0.611216S representa uma duração de cerca de 0.61 segundos.
  • securityContext define o contexto de segurança no qual o DSC foi executado. Se o valor dessa propriedade de metadados for Elevated, o DSC foi executado como root (não Windows) ou uma sessão elevada com privilégios de Administrador (no Windows). Se o valor for Restricted, o DSC foi executado como um usuário ou conta normal em uma sessão não elevada.

Resultados obtidos

Define a lista de resultados para a operação de set invocada contra cada instância no documento de configuração. Cada entrada na lista inclui o nome do tipo do recurso, o nome da instância e os dados de resultado de uma instância.

Type:      array
Required:  true
ItemsType: object

tipo

A propriedade type de um item identifica o recurso DSC da instância por seu nome de tipo totalmente qualificado. Para obter mais informações sobre nomes de tipo, consulte de referência de esquema de nome de tipo totalmente qualificado do recurso DSC .

Type:     string
Required: true
Pattern:  ^\w+(\.\w+){0,2}\/\w+$

Designação

A propriedade name de um item identifica a instância por seu nome curto, exclusivo e legível por humanos.

Type:     string
Required: true

Resultado

A propriedade result de um item inclui o estado imposto para a instância de recurso. O valor dessa propriedade adere ao mesmo esquema que a saída para o comando dsc resource set. Para obter mais informações, consulte referência de esquema de resultado do conjunto de recursos dsc.

mensagens

Define a lista de mensagens estruturadas emitidas por recursos durante a operação definida. Para obter mais informações, consulte Referência de esquema de mensagem estruturada.

Type:     array
Required: true

hadErrors

Indica se a operação encontrou erros. Esse valor é true se o documento de configuração falhou na validação ou se qualquer recurso saiu com um código de saída diferente de 0.

Type:     boolean
Required: true
  • Last updated on