Sdílet prostřednictvím

Skript

  • Článek

Synopse

Spusťte bloky skriptů PowerShellu.

Syntax

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

Description

Tento Script prostředek umožňuje napsat kód PowerShellu, který získá, otestuje a nastaví prostředek v případě, že konkrétní prostředek DSC není k dispozici. Musíte zadat kód pro tyto metody, zpracovat všechny závislosti a zajistit idempotentní kód.

Tip

Pokud je to možné, osvědčeným postupem je místo tohoto prostředku použít definovaný prostředek DSC. Prostředek Script má nevýhody, které ztěžují testování, údržbu a predikci.

Na rozdíl od jiných prostředků DSC je každá vlastnost prostředku Script klíčovou vlastností a metoda Get pro tento prostředek může vrátit pouze jeden řetězec pro aktuální stav. Neexistují žádné záruky, že se tento prostředek implementuje idempotentní způsobem nebo že bude fungovat podle očekávání v jakémkoli systému, protože používá vlastní kód. Nelze ho otestovat bez vyvolání v cílovém systému.

Před použitím Script prostředku zvažte, jestli místo toho můžete prostředek vytvořit . Díky dobře definovaným prostředkům DSC budou vaše konfigurace lépe čitelné a udržovatelné.

Požadavky

Žádné

Vlastnosti

Základní vlastnosti

GetScript

Zadejte powershellový skriptblock, který načte aktuální stav prostředku. Tento scriptblock se spustí při vyvolání metody Get pro tento prostředek.

Tento skriptblock by měl vrátit tabulku hash obsahující jeden klíč s názvem Result a řetězcovou hodnotou.

Type: System.String

SetScript

Zadejte powershellový skriptblock, který nakonfiguruje prostředek do požadovaného stavu. Tento blok skriptu se spustí při vyvolání metody Set pro tento prostředek.

Výstupem tohoto bloku skriptu by neměly být žádné objekty. Tento blok skriptu by měl být zapsán idempotentní, takže vyvolání set metody dvakrát ponechá cíl ve stejném stavu, jako vyvolání jednou.

Type: System.String

TestScript

Zadejte powershellový skriptblock, který ověří, jestli je prostředek v požadovaném stavu. Tento blok skriptu se spustí při vyvolání metody Test pro tento prostředek.

Tento blok skriptu by se měl vrátit $true , pokud je prostředek v požadovaném stavu a $false není v požadovaném stavu.

Type: System.String

Volitelné vlastnosti

Reference

Zadejte přihlašovací údaje účtu, pod který se v případě potřeby mají skriptbloky spustit.

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

Vlastnosti jen pro čtení

Výsledek

Výsledek z bloku skriptu GetScript .

Type: System.String

Příklady