重新启动节点

注意

本主题讨论如何重新启动节点。 若要使重新启动成功，需要正确配置 ActionAfterReboot 和 RebootNodeIfNeeded LCM 设置。 若要了解本地配置管理器设置，请参阅配置本地配置管理器或配置本地配置管理器 (v4)。

可以使用 $global:DSCMachineStatus 标志，从资源中重新启动节点。 在 Set-TargetResource 函数中将此标志设置为 1 会强制 LCM 在当前资源的 Set 方法之后直接重新启动节点。 如果使用此标志，ComputerManagementDsc DSC 资源模块中的 PendingReboot 资源会检测 DSC 外部是否有挂起的重启。

配置可能会执行需要重新启动节点的步骤。 这可能包括诸如以下这类情况：

• Windows 更新
• 安装软件
• 文件重命名
• 计算机重命名

PendingReboot 资源会检查特定计算机位置，以确定是否有挂起的重启。 如果节点需要在 DSC 外部重启，则 PendingReboot 资源会将 $global:DSCMachineStatus 标志设置为 1，从而强制重启并解决挂起条件。

注意

任何 DSC 资源都可以通过在 Set-TargetResource 函数中设置此标志，来指示 LCM 重新启动节点。 有关详细信息，请参阅使用 MOF 编写自定义 DSC 资源。

语法

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

属性

属性	描述
名称	必需参数，对配置中资源的每个实例必须唯一。
SkipComponentBasedServicing	跳过由基于组件的服务组件触发的重新启动。
SkipWindowsUpdate	跳过由 Windows 更新触发的重新启动。
SkipPendingFileRename	跳过挂起文件重命名重新启动。
SkipCcmClientSDK	跳过由 ConfigMgr 客户端触发的重新启动。
SkipComputerRename	跳过由计算机重命名触发的重新启动。
PSDSCRunAsCredential	在 v5 中受支持。 以指定用户身份执行资源。
DependsOn	指示必须先运行其他资源的配置，再配置此资源。 例如，如果你想要首先运行 ID 为 ResourceName、类型为 ResourceType 的资源配置脚本块，则使用此属性的语法为 DependsOn = "[ResourceType]ResourceName"。 有关详细信息，请参阅使用 DependsOn

示例

下面的示例使用 xExchange 资源安装 Microsoft Exchange。 在整个安装过程中，PendingReboot 资源用于重启节点。

注意

此示例需要有权向林中添加 Exchange 服务器的帐户的凭据。 有关在 DSC 中使用凭据的详细信息，请参阅在 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'
        }
    }
}

注意

此示例假设已将本地配置管理器配置为允许重新启动并在重新启动之后继续配置。

下载位置

可以在以下位置或使用 PowerShell 库下载本主题中使用的资源。

• ComputerManagementDsc
• xExchange