Start-DscConfiguration

将配置应用到节点。

语法

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Start-DscConfiguration cmdlet 将配置应用于节点。 与 UseExisting 参数一起使用时,将应用目标计算机上的现有配置。 通过指定计算机名称或使用 Common Information Model (CIM) 会话指定要应用配置的计算机。

默认情况下,此 cmdlet 会创建一个作业,并返回 Job 对象。 有关后台作业的详细信息,请键入 Get-Help about_Jobs。 若要以交互方式使用此 cmdlet,请指定 Wait 参数。

指定 Verbose 参数,以查看该 cmdlet 在应用配置设置时所执行的操作的详细信息。

示例

示例 1:应用配置设置

Start-DscConfiguration -Path "C:\DSC\Configurations\"

此命令将配置设置应用于 C:\DSC\Configurations\ 具有该文件夹中设置的每台计算机。 对于部署到的每个目标节点,该命令将返回 Job 对象。

示例 2:应用配置设置并等待配置完成

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

此命令将配置从 C:\DSC\Configurations\ 本地计算机应用到本地计算机。 对于部署到的每个目标节点(在此示例中,仅为本地计算机),该命令将返回 Job 对象。 此示例指定 Verbose 参数。 因此,该命令在继续操作时将消息发送到控制台。 该命令包括 Wait 参数。 因此,在命令完成所有配置任务之前,无法使用控制台。

示例 3:使用 CIM 会话应用配置设置

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

此示例将配置设置应用到指定的计算机。 该示例为名为 Server01 的计算机创建 CIM 会话,以供与 cmdlet 一起使用。 或者,创建一个 CIM 会话数组以将 cmdlet 应用到多个指定的计算机。

第一个命令使用 New-CimSession cmdlet 创建 CIM 会话,然后将 CimSession 对象存储在变量中 $Session 。 该命令会提示你输入密码。 要了解详情,请键入 Get-Help NewCimSession

第二个命令将配置设置应用于C:\DSC\Configurations存储在$Session变量中的 CimSession 对象标识的计算机。 在此示例中,变量 $Session 仅包含名为 Server01 的计算机的 CIM 会话。 该命令应用此配置。 该命令为每个已配置的计算机创建 Job 对象。

参数

-CimSession

在远程会话中或在远程计算机上运行 cmdlet。 输入计算机名称或会话对象,例如 New-CimSessionGet-CimSession cmdlet 的输出。 默认为本地计算机上的当前会话。

Type:CimSession[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

指定一个计算机名称数组。 此参数将 Path 参数中的配置文档的计算机限制为数组中指定的文档。

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

针对目标计算机,指定用户名和密码作为 PSCredential 对象。 若要获取 PSCredential 对象,请使用 Get-Credential cmdlet。 要了解详情,请键入 Get-Help Get-Credential

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

停止当前在目标计算机上运行的配置操作,并开始新的Start-Configuration操作。 如果本地Configuration Manager的 RefreshMode 属性设置为“拉取”,则指定此参数将其更改为“推送”。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-JobName

为作业指定一个友好名称。 如果指定此参数,则 cmdlet 将作为作业运行,并且它将返回 Job 对象。

默认情况下,Windows PowerShell分配名称 JobN,其中 N 为整数。

如果指定 Wait 参数,则不指定此参数。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

指定包含配置设置文件的文件夹的文件路径。 此 cmdlet 会将这些配置设置发布到具有指定路径中设置文件的计算机。 每个目标节点必须具有以下格式的设置文件: <NetBIOS Name>.mof

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

指定可为运行 cmdlet 而确立的操作的最大数量。 如果省略此参数或输入值0,则Windows PowerShell根据计算机上运行的 CIM cmdlet 数计算 cmdlet 的最佳限制限制。 该限制仅适用于当前 cmdlet,不适用于会话或计算机。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseExisting

指示此 cmdlet 应用现有配置。 可以通过使用 Start-DscConfiguration Publish-DscConfiguration cmdlet 进行颁布或通过发布来存在于目标计算机上。

在为此 cmdlet 指定此参数之前,请查看 Windows PowerShell 5.0 中的新增功能中的信息。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Wait

指示该 cmdlet 会阻止控制台,直到它完成所有配置任务。

如果指定此参数,则不指定 JobName 参数。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False