Restartování uzlu

Poznámka:

Toto téma pojednává o tom, jak restartovat uzel. Aby byl restart úspěšný, musí být správně nakonfigurována nastavení LCM ActionAfterReboot a RebootNodeIfNeeded . Informace o nastavení místního nástroje Configuration Manager naleznete v tématu Konfigurace místního nástroje Configuration Manager nebo Konfigurace místního nástroje Configuration Manager (v4).

Uzly lze restartovat z prostředku pomocí příznaku $global:DSCMachineStatus . Nastavení tohoto příznaku ve Set-TargetResource funkci na 1 vynutí, aby LCM restartoval uzel přímo po metodě Set aktuálního zdroje. Pomocí tohoto příznaku prostředek PendingReboot v modulu prostředků ComputerManagementDsc DSC zjistí, zda mimo DSC čeká na restart.

Vaše konfigurace mohou provádět kroky, které vyžadují restartování uzlu. To může zahrnovat například tyto položky:

• Aktualizace Windows
• Instalace softwaru
• Přejmenování souborů
• Přejmenování počítače

Prostředek PendingReboot zkontroluje konkrétní umístění počítače a určí, zda čeká na restartování. Pokud uzel vyžaduje restartování mimo DSC, prostředek PendingReboot nastaví $global:DSCMachineStatus příznak na 1 vynucení restartu a vyřešení čekající podmínky.

Poznámka:

Jakýkoli prostředek DSC může dát LCM pokyn k restartování uzlu nastavením tohoto příznaku ve Set-TargetResource funkci. Další informace najdete v tématu Zápis vlastního prostředku DSC pomocí MOF.

Syntaxe

PendingReboot [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
    [SkipCcmClientSDK = [bool]]
    [SkipComponentBasedServicing = [bool]]
    [SkipPendingComputerRename = [bool]]
    [SkipPendingFileRename = [bool]]
    [SkipWindowsUpdate = [bool]]
}

Vlastnosti

Vlastnictví	Description
Název	Povinný parametr, který musí být jedinečný pro každou instanci prostředku v rámci konfigurace.
SkipComponentBasedServicing	Přeskočí restartování aktivovaná komponentou Component-Based Servicing .
Přeskočit aktualizaci systému Windows	Přeskočte restarty spuštěné službou Windows Update.
Přeskočení nadřazeného_souboruPřejmenování	Přeskočí čekající restartování přejmenování souboru.
Přeskočit sadu SDK (SkipCcmClientSDK)	Přeskočte restartování aktivovaná klientem nástroje ConfigMgr.
Přeskočit počítač	Přeskočí restartování spuštěná přejmenováním počítače.
PSDSCRunAsCredential	Podporováno ve verzi v5. Spustí prostředek jako zadaný uživatel.
Závisí na	Označuje, že před konfigurací tohoto prostředku musí být spuštěna konfigurace jiného prostředku. Pokud je například ID bloku konfiguračního skriptu prostředku, který chcete spustit jako první, ResourceName a jeho typ je ResourceType, syntaxe pro použití této vlastnosti je DependsOn = "[ResourceType]ResourceName". Další informace naleznete v tématu Použití DependsOn

Example

Následující příklad nainstaluje Microsoft Exchange pomocí prostředku xExchange . V průběhu instalace se k restartování uzlu používá prostředek PendingReboot .

Poznámka:

Tento příklad vyžaduje pověření účtu, který má práva k přidání serveru Exchange do doménové struktury. Další informace o používání přihlašovacích údajů v DSC najdete v tématu Zpracování přihlašovacích údajů v DSC.

$ConfigurationData = @{
    AllNodes = @(
        @{
            NodeName                    = '*'
            PSDSCAllowPlainTextPassword = $true
        },
        @{
            NodeName = 'DSCPULL-1'
        }
    )
}

Configuration Example
{
    param
    (
        [Parameter(Mandatory = $true)]
        [System.Management.Automation.PSCredential]
        $ExchangeAdminCredential
    )

    Import-DSCResource -ModuleName xExchange
    Import-DSCResource -ModuleName ComputerManagementDsc

    Node $AllNodes.NodeName
    {
        # Copy the Exchange setup files locally
        File ExchangeBinaries
        {
            Ensure          = 'Present'
            Type            = 'Directory'
            Recurse         = $true
            SourcePath      = '\\rras-1\Binaries\E15CU6'
            DestinationPath = 'C:\Binaries\E15CU6'
        }

        # Check if a reboot is needed before installing Exchange
        PendingReboot BeforeExchangeInstall
        {
            Name       = 'BeforeExchangeInstall'
            DependsOn  = '[File]ExchangeBinaries'
        }

        # Do the Exchange install
        xExchInstall InstallExchange
        {
            Path       = 'C:\Binaries\E15CU6\Setup.exe'
            Arguments  = '/mode:Install /role:Mailbox /Iacceptexchangeserverlicenseterms'
            Credential = $ExchangeAdminCredential
            DependsOn  = '[PendingReboot]BeforeExchangeInstall'
        }

        # See if a reboot is required after installing Exchange
        PendingReboot AfterExchangeInstall
        {
            Name      = 'AfterExchangeInstall'
            DependsOn = '[xExchInstall]InstallExchange'
        }
    }
}

Poznámka:

V tomto příkladu se předpokládá, že jste nakonfigurovali místní nástroj Configuration Manager tak, aby umožňoval restartování a pokračoval v konfiguraci i po restartování.

Kde stáhnout

Prostředky použité v tomto tématu si můžete stáhnout v následujících umístěních nebo pomocí galerie prostředí PowerShell.

• ComputerManagementDsc
• xExchange