Share via

Script

  • Artículo

Sinopsis

Ejecute bloques de scripts de PowerShell.

Sintaxis

Script [String] #ResourceName
{
    GetScript = [string]
    SetScript = [string]
    TestScript = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
}

Descripción

El Script recurso permite escribir código de PowerShell para obtener, probar y establecer un recurso cuando un recurso de DSC específico no está disponible. Debe proporcionar el código para estos métodos, controlar todas las dependencias y asegurarse de que el código es idempotente.

Sugerencia

Siempre que sea posible, se recomienda usar un recurso de DSC definido en lugar de este. El Script recurso tiene inconvenientes que dificultan la prueba, el mantenimiento y la predicción.

A diferencia de otros recursos de DSC, cada propiedad de un Script recurso es una propiedad clave y el método Get de este recurso solo puede devolver una sola cadena para el estado actual. No hay garantías de que este recurso se implemente de forma idempotente o que funcionará según lo previsto en cualquier sistema porque usa código personalizado. No se puede probar sin invocarse en un sistema de destino.

Antes de usar el Script recurso, considere si puede crear un recurso en su lugar. El uso de recursos de DSC bien definidos hace que las configuraciones se puedan leer y mantener.

Requisitos

Ninguno.

Propiedades

Propiedades de la clave

GetScript

Especifique un bloque de scripts de PowerShell que recupere el estado actual del recurso. Este scriptblock se ejecuta cuando se invoca el método Get para este recurso.

Este scriptblock debe devolver una tabla hash que contenga una clave denominada Result con un valor de cadena.

Type: System.String

SetScript

Especifique un bloque de scripts de PowerShell que configure el recurso en el estado deseado. Este bloque de script se ejecuta cuando se invoca el método Set para este recurso.

Este bloque de script no debe generar ningún objeto. Este bloque de script debe escribirse idempotentemente, de modo que invocar el método Set dos veces deja el destino en el mismo estado que invocarlo una vez.

Type: System.String

TestScript

Especifique un bloque de scripts de PowerShell que valide si el recurso está en estado deseado. Este bloque de script se ejecuta cuando se invoca el método Test para este recurso.

Este bloque de script debe devolver $true si el recurso está en el estado deseado y $false si no está en el estado deseado.

Type: System.String

Propiedades opcionales

Credencial

Especifique la credencial de una cuenta para ejecutar los bloqueos de script en si es necesario.

Type: System.Management.Automation.PSCredential
Default Value: None

Propiedades de solo lectura

Resultado

Resultado del bloque de script GetScript .

Type: System.String

Ejemplos