La configuración de estado deseado de PowerShell se construye en torno a un proceso Obtener, Probar y Establecer. Cada recurso de DSC contiene métodos para completar cada una de estas operaciones. En una configuración, define bloques de recursos para completar claves que se convierten en parámetros para los métodos Get, Test y Set de un recurso.
Esta es la sintaxis para un bloque de recursos de servicio. El recurso Servicio configura los servicios de Windows.
Service [String] #ResourceName
{
Name = [string]
[BuiltInAccount = [string]{ LocalService | LocalSystem | NetworkService }]
[Credential = [PSCredential]]
[Dependencies = [string[]]]
[DependsOn = [string[]]]
[Description = [string]]
[DisplayName = [string]]
[Ensure = [string]{ Absent | Present }]
[Path = [string]]
[PsDscRunAsCredential = [PSCredential]]
[StartupType = [string]{ Automatic | Disabled | Manual }]
[State = [string]{ Running | Stopped }]
}
Los métodos Get, Test y Set del recurso Service tendrán bloques de parámetros que aceptan estos valores.
param
(
[parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[System.String]
$Name,
[System.String]
[ValidateSet("Automatic", "Manual", "Disabled")]
$StartupType,
[System.String]
[ValidateSet("LocalSystem", "LocalService", "NetworkService")]
$BuiltInAccount,
[System.Management.Automation.PSCredential]
[ValidateNotNull()]
$Credential,
[System.String]
[ValidateSet("Running", "Stopped")]
$State="Running",
[System.String]
[ValidateNotNullOrEmpty()]
$DisplayName,
[System.String]
[ValidateNotNullOrEmpty()]
$Description,
[System.String]
[ValidateNotNullOrEmpty()]
$Path,
[System.String[]]
[ValidateNotNullOrEmpty()]
$Dependencies,
[System.String]
[ValidateSet("Present", "Absent")]
$Ensure="Present")
El idioma y el método utilizados para definir el recurso determinan cómo se definirán los métodos Get, Test y Set.
Debido a que el recurso de servicio solo tiene una clave requerida (nombre), un recurso de bloque de servicio podría ser tan simple como esto:
Configuration TestConfig
{
Import-DSCResource -Name Service
Node localhost
{
Service «MyService»
{
Name = «Spooler»
}
}
}
Cuando compila la configuración anterior, los valores que especifica para una clave se almacenan en el archivo .mof que se genera. Para obtener más información, consulte MOF.
instance of MSFT_ServiceResource as $MSFT_ServiceResource1ref
{
SourceInfo = «::5::1::Service»;
ModuleName = «PsDesiredStateConfiguration»;
ResourceID = «[Service]MyService»;
Name = «Spooler»;
ModuleVersion = «1.0»;
ConfigurationName = «Test»;
};
Cuando se aplica, el Administrador de configuración local (LCM) leerá el valor «Spooler» del archivo .mof y lo pasará al parámetro Nombre de los métodos Get, Test y Set para la instancia «MyService» del recurso de servicio.
Continuará…