Skript

  • Artikel

Synopsis

Kör PowerShell-skriptblock.

Syntax

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

Description

Med resursen Script kan du skriva PowerShell-kod för att hämta, testa och ange en resurs när en specifik DSC-resurs inte är tillgänglig. Du måste ange koden för dessa metoder, hantera alla beroenden och se till att koden är idempotent.

Tips

Om möjligt är det bästa praxis att använda en definierad DSC-resurs i stället för den här. Resursen Script har nackdelar som gör det svårare att testa, underhålla och förutsäga.

Till skillnad från andra DSC-resurser är varje egenskap för en Script resurs en nyckelegenskap och metoden Get för den här resursen kan bara returnera en enskild sträng för det aktuella tillståndet. Det finns inga garantier för att den här resursen implementeras idempotent eller att den fungerar som förväntat i alla system eftersom den använder anpassad kod. Det kan inte testas utan att anropas på ett målsystem.

Innan du använder resursen Script bör du överväga om du kan skapa en resurs i stället. Om du använder väldefinierade DSC-resurser blir konfigurationerna mer läsbara och underhållsbara.

Krav

Inga.

Egenskaper

Nyckelegenskaper

GetScript

Ange ett PowerShell-skriptblock som hämtar resursens aktuella tillstånd. Det här skriptblocket körs när metoden Get för den här resursen anropas.

Den här scriptblock ska returnera en hash-tabell som innehåller en nyckel med namnet Result med ett strängvärde.

Type: System.String

SetScript

Ange ett PowerShell-skriptblock som konfigurerar resursen till önskat tillstånd. Det här skriptblocket körs när metoden Set för den här resursen anropas.

Det här skriptblocket bör inte mata ut några objekt. Det här skriptblocket ska skrivas idempotent, så att anrop av metoden Set två gånger lämnar målet i samma tillstånd som när det anropas en gång.

Type: System.String

TestScript

Ange ett PowerShell-skriptblock som verifierar om resursen är i önskat tillstånd. Det här skriptblocket körs när testmetoden för den här resursen anropas.

Det här skriptblocket ska returneras $true om resursen är i önskat tillstånd och $false om den inte är i önskat tillstånd.

Type: System.String

Valfria egenskaper

Merit

Ange autentiseringsuppgifterna för ett konto som skriptblocken ska köras under om det behövs.

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

Skrivskyddade egenskaper

Resultat

Resultatet från GetScript-skriptblocket .

Type: System.String

Exempel