Start-DscConfiguration

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

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

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

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

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

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

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

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

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

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

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

$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 对象标识的计算机。 在此示例中，$Session 变量仅包含名为 Server01 的计算机的 CIM 会话。 该命令应用配置。 该命令为每个配置的计算机创建 作业 对象。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。