Script
Sinopse
Executar blocos de script do PowerShell.
Sintaxe
Script [String] #ResourceName
{
GetScript = [string]
SetScript = [string]
TestScript = [string]
[Credential = [PSCredential]]
[DependsOn = [string[]]]
[PsDscRunAsCredential = [PSCredential]]
}
Descrição
O Script
recurso permite que você escreva o código do PowerShell para obter, testar e definir um recurso quando um recurso de DSC específico não estiver disponível. Você deve fornecer o código para esses métodos, lidar com todas as dependências e garantir que seu código seja idempotente.
Dica
Sempre que possível, é recomendável usar um recurso de DSC definido em vez deste. O Script
recurso tem desvantagens que dificultam o teste, a manutenção e a previsão.
Ao contrário de outros recursos de DSC, cada propriedade de um Script
recurso é uma propriedade de chave e o método Get para esse recurso só pode retornar uma única cadeia de caracteres para o estado atual. Não há garantias de que esse recurso seja implementado de forma idempotente ou que ele funcione conforme o esperado em qualquer sistema porque usa código personalizado. Ele não pode ser testado sem ser invocado em um sistema de destino.
Antes de usar o Script
recurso, considere se você pode criar um recurso .
O uso de recursos de DSC bem definidos torna suas configurações mais legíveis e mantenedíveis.
Requisitos
Nenhum.
Propriedades
Propriedades da chave
GetScript
Especifique um scriptblock do PowerShell que recupera o estado atual do recurso. Esse scriptblock é executado quando o método Get para esse recurso é invocado.
Esse scriptblock deve retornar uma tabela de hash que contém uma chave chamada Result
com um valor de cadeia de caracteres.
Type: System.String
SetScript
Especifique um scriptblock do PowerShell que configure o recurso para o estado desejado. Esse bloco de script é executado quando o método Set para esse recurso é invocado.
Esse bloco de script não deve gerar nenhum objeto. Esse bloco de script deve ser gravado de forma idempotente, de modo que invocar o método Set duas vezes deixa 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 desejado. Esse bloco de script é executado quando o método Test para esse recurso é invocado.
Esse bloco de script deverá retornar $true
se o recurso estiver no estado desejado e $false
se ele não estiver no estado desejado.
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 somente leitura
Result
O resultado do bloco de script GetScript .
Type: System.String
Exemplos
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de