Partilhar via

Script

  • Artigo

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

Exemplos