Compartir a través de

Operaciones de recursos de DSC

DSC define un conjunto de operaciones que los recursos pueden implementar. DSC invoca las operaciones para usar recursos para diferentes tareas. No todos los recursos implementan todas las operaciones.

Las operaciones generales para administrar el estado del sistema son Get, Test y Set.

En el resto de este documento se describen las operaciones de recursos disponibles.

Obtener operación

La operación Get devuelve el estado real de una instancia de recurso específica en el sistema.

Esta operación solo está disponible para los recursos que tienen la capacidad get.

DSC invoca la operación Get cuando se utilizan los siguientes comandos:

  • dsc resource get para devolver el estado real de una instancia de recurso.
  • dsc config get para devolver el estado real de cada instancia de un documento de configuración.

Operación de prueba

La operación de prueba compara el estado real de una instancia de recurso específica en el sistema con un estado deseado especificado. El resultado indica no solo si la instancia está en el estado deseado, sino también cómo difiere el estado real del estado deseado.

Si un recurso no tiene la capacidad de prueba, DSC prueba sintéticamente el recurso.

DSC invoca la operación Test cuando se utilizan los siguientes comandos:

  • dsc resource test para probar el estado deseado de una instancia de recurso específica.
  • dsc config test para probar el estado deseado de cada instancia en un documento de configuración.

Establecer operación

La operación Set aplica el estado deseado de una instancia de recurso en un sistema. El resultado indica cómo el recurso modificó el sistema.

Esta operación solo está disponible para los recursos con la capacidad establecida.

DSC invoca la operación Set cuando se utilizan los siguientes comandos:

  • dsc resource set para aplicar el estado deseado de una instancia de recurso específica.
  • dsc config get para aplicar el estado deseado definido por un documento de configuración.

Operación de eliminación

La operación Delete quita una instancia de recurso de un sistema. La operación no devuelve ninguna salida.

Esta operación solo está disponible para los recursos con la capacidad de eliminación.

DSC invoca la operación Delete cuando se utilizan los siguientes comandos:

  • dsc resource delete para eliminar una instancia de recurso específica.

Operación de exportación

La operación Export recupera el estado real de cada instancia del recurso en un sistema. El resultado es un documento de configuración que incluye las instancias exportadas.

Esta operación solo está disponible para los recursos con la capacidad de exportación.

DSC invoca la operación de exportación cuando se utilizan los siguientes comandos:

  • dsc resource export para devolver un documento de configuración que enumera el estado real de cada instancia de un recurso específico.
  • dsc config export para devolver un documento de configuración que enumera el estado real de cada instancia de un documento de configuración.
  • dsc resource get con la opción de devolver el estado real de cada instancia de un recurso específico como una matriz de resultados de la --all operación Get .

Operación de lista

La operación List recupera los recursos adaptados disponibles para un recurso de adaptador de DSC específico.

Esta operación solo está disponible para los recursos del adaptador.

Operación de validación

La operación Validate indica si una instancia del recurso está definida de forma válida. Los recursos de comando utilizan su esquema de instancia de recursos para la validación. Los recursos del adaptador implementan la operación Validate para permitir que DSC valide los recursos adaptados, que podrían no tener un esquema JSON definido.

DSC invoca la operación Validate en los recursos del adaptador al validar instancias de recursos adaptados en un documento de configuración o cuando se utilizan los dsc resource comandos para invocar directamente un recurso adaptado.

Operación de resolución

La operación Resolve procesa una instancia de recurso de importador para devolver un documento de configuración.

Esta operación solo está disponible para los recursos con la capacidad de resolución. Esta operación es principalmente útil para los recursos del importador.

Consulte también