Script
Sinopse
Execute blocos de script do PowerShell.
Syntax
Script [String] #ResourceName
{
GetScript = [string]
SetScript = [string]
TestScript = [string]
[Credential = [PSCredential]]
[DependsOn = [string[]]]
[PsDscRunAsCredential = [PSCredential]]
}
Descrição
O Script
recurso permite-lhe escrever código do PowerShell para obter, testar e definir um recurso quando não está disponível um recurso DSC específico. Tem de fornecer o código para estes métodos, processar todas as dependências e garantir que o código é idempotente.
Dica
Sempre que possível, é melhor prática utilizar um recurso DSC definido em vez deste. O Script
recurso tem desvantagens que tornam mais difícil testar, manter e prever.
Ao contrário de outros recursos do DSC, cada propriedade de um Script
recurso é uma propriedade chave e o método Get para este recurso só pode devolver uma única cadeia para o estado atual. Não existem garantias de que este recurso seja implementado de forma idempotente ou que funcione conforme esperado em qualquer sistema, uma vez que utiliza código personalizado. Não pode ser testado sem ser invocado num sistema de destino.
Antes de utilizar o Script
recurso, considere se pode criar um recurso .
A utilização de recursos DSC bem definidos torna as suas configurações mais legíveis e mantêveis.
Requisitos
Nenhum.
Propriedades
Propriedades principais
GetScript
Especifique um scriptblock do PowerShell que obtém o estado atual do recurso. Este scriptblock é executado quando o método Get para este recurso é invocado.
Este scriptblock deve devolver uma tabela hash com uma chave chamada Result
com um valor de cadeia.
Type: System.String
SetScript
Especifique um scriptblock do PowerShell que configure o recurso para o estado pretendido. Este bloco de script é executado quando o método Set para este recurso é invocado.
Este bloco de scripts não deve produzir objetos. Este bloco de script deve ser escrito idempotentemente, para que invocar o método Set duas vezes deixe o destino no mesmo estado que invocá-lo uma vez.
Type: System.String
TestScript
Especifique um scriptblock do PowerShell que valide se o recurso está no estado pretendido. Este bloco de script é executado quando o Método de teste para este recurso é invocado.
Este bloco de script deve devolver $true
se o recurso estiver no estado pretendido e $false
se não estiver no estado pretendido.
Type: System.String
Propriedades opcionais
Credencial
Especifique a credencial de uma conta para executar os scriptblocks em, se necessário.
Type: System.Management.Automation.PSCredential
Default Value: None
Propriedades só de leitura
Resultado
O resultado do bloco de script GetScript .
Type: System.String