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>]

说明

cmdlet Start-DscConfiguration 将配置应用于节点。 与 UseExisting 参数一起使用时,将应用目标计算机上的现有配置。 通过指定计算机名称或使用通用信息模型 (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配置设置应用于由存储在 变量中的 $SessionCimSession 对象标识的计算机。 在此示例中, $Session 变量仅包含名为 Server01 的计算机的 CIM 会话。 该命令应用此配置。 该命令为每个已配置的计算机创建 Job 对象。

参数

-CimSession

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

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

-ComputerName

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

停止当前在目标计算机上运行的配置操作,并开始新的 Start-Configuration 操作。 如果 Local Configuration Manager的 RefreshMode 属性设置为 Pull,则指定此参数会将其更改为 Push

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

-JobName

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

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

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

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

-Path

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

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

-ThrottleLimit

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

Type:Int32
Position:Named
Default value:None
Required:False
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Wait

指示 cmdlet 在完成所有配置任务之前阻止控制台。

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

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。

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