Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.