Start-DscConfiguration

参考

模块:: PSDesiredStateConfiguration

将配置应用于节点。

语法

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 参数。

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

示例

示例 1：应用配置设置

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

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

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

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

此命令将 C:\DSC\Configurations\ 配置应用到本地计算机。此命令返回作业部署到的每个目标节点的对象，在本例中，仅返回本地计算机。此示例指定 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 会话。该命令应用配置。该命令为每个配置的计算机创建作业对象。

参数

-CimSession

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

类型:	CimSession[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ComputerName

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

类型:	String[]
别名:	CN, ServerName
Position:	1
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

指定目标计算机的 PSCredential 对象的用户名和密码。若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。有关详细信息，请键入 Get-Help Get-Credential。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

停止当前在目标计算机上运行的配置作，并开始新的 Start-Configuration作。如果本地配置管理器的 RefreshMode 属性设置为“拉取，则指定此参数将更改为 Push。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-JobName

指定作业的友好名称。如果指定此参数，则 cmdlet 将作为作业运行，并返回 Job 对象。

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

如果指定 Wait 参数，请不要指定此参数。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

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

类型:	String
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ThrottleLimit

指定可以建立以运行 cmdlet 的最大并发作数。如果省略此参数或输入 0 值，则 Windows PowerShell 会根据计算机上运行的 CIM cmdlet 数计算 cmdlet 的最佳限制。限制限制仅适用于当前 cmdlet，不适用于会话或计算机。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseExisting

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

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Wait

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

如果指定此参数，请不要指定 JobName 参数。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

通过