Informazioni di riferimento sullo schema delle proprietà dei metadati Microsoft.DSC

Sinossi

Proprietà dei metadati usate e restituite da DSC per le operazioni di configurazione e risorse.

Description

L'oggetto Microsoft.DSC metadati acquisisce i dettagli di esecuzione che DSC aggiunge all'output del comando e, se applicabile, ai risultati delle risorse. Descrive l'operazione eseguita, la data di avvio e di fine, il tempo impiegato, il contesto di sicurezza in cui è stato eseguito DSC e la versione DSC che ha prodotto l'output. Queste proprietà sono informative e consentono di eseguire la diagnostica, il controllo e gli strumenti.

Non tutte le proprietà sono presenti per ogni operazione. Ad esempio, executionType è significativo solo per Set (ed è WhatIf quando si richiama DSC con --whatIf), while operation è sempre fornito. I timestamp utilizzano il formato RFC 3339 date-time e le durate utilizzano il formato ISO 8601 duration .

I consumatori devono tollerare ulteriori campi di metadati futuri. I produttori devono conservare i metadati sconosciuti che non interpretano.

Proprietà

duration

Definisce la durata di un'operazione DSC su un documento di configurazione o un'istanza di risorsa come stringa che segue il formato definito in ISO8601 ABNF per duration.

Ad esempio, PT0.611216S rappresenta una durata di circa 0.61 secondi.

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/metadata/Microsoft.DSC/duration.json
Type:          string
Format:        duration

endDateTime

Definisce la data e l'ora di fine dell'operazione DSC come timestamp seguendo il formato definito in RFC3339, sezione 5.6 (vedere date-time).

Ad esempio: 2024-04-14T08:49:51.395686600-07:00

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/metadata/Microsoft.DSC/endDateTime.json
Type:          string
Format:        date-time

executionType

Definisce se DSC ha effettivamente applicato un'operazione alla configurazione o è stato eseguito in WhatIf modalità. Questa proprietà è sempre Actual per Getle operazioni , Test, e Export . Per Set le operazioni, questo valore si verifica WhatIf quando DSC viene richiamato con l'argomento --whatIf .

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/metadata/Microsoft.DSC/executionType.json
Type:          string
ValidValues:  [Actual, WhatIf]

operation (operazione)

Definisce l'operazione applicata da DSC al documento di configurazione: Get, Set, Test, o Export.

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/metadata/Microsoft.DSC/operation.json
Type:          string
ValidValues:  [Get, Set, Test, Export]

securityContext

Definisce il contesto di sicurezza in cui è stato eseguito DSC. Se il valore di questa proprietà dei metadati è Elevated, DSC è stato eseguito come root (non Windows) o come sessione con privilegi elevati con privilegi di amministratore (in Windows). Se il valore è Restricted, DSC è stato eseguito come utente o account normale in una sessione non con privilegi elevati.

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/metadata/Microsoft.DSC/securityContext.json
Type:          string
ValidValues:  [Current, Elevated, Restricted]

startDatetime

Definisce la data e l'ora di inizio per l'operazione DSC come timestamp seguendo il formato definito in RFC3339, sezione 5.6 (vedere date-time).

Ad esempio: 2024-04-14T08:49:51.395686600-07:00

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.1.0/metadata/Microsoft.DSC/startDatetime.json
Type:          string
Format:        date-time

version

Definisce la versione di DSC che ha eseguito il comando. Questo valore è sempre la versione semantica del comando DSC, ad esempio 3.0.0-preview.7.

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