Skript
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
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för