Stop-DscConfiguration

参考

模块:: PSDesiredStateConfiguration

停止正在运行的配置作业。

语法

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Stop-DscConfiguration cmdlet 停止正在运行的配置作业。使用 Common Information Model （CIM）会话指定此 cmdlet 适用的计算机。如果没有运行配置作业，此 cmdlet 将返回警告消息。

Stop-DscConfiguration 仅在 2014 年 11 月 Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R2 更新汇总的一部分提供， Microsoft支持库提供。使用此 cmdlet 之前，请查看 Windows PowerShell 5.0 中新增功能中的信息

示例

示例 1：停止配置作业

在此示例中，将使用 New-CimSession cmdlet 创建 CIM 会话。 CimSession 对象用于停止正在运行的配置作业。

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession 使用 ComputerName 参数指定 Server01 计算机。 Credential 参数指定用户帐户。 CimSession 对象存储在 $Session 变量中。运行该命令时，系统会提示输入用户帐户的密码。

Stop-DscConfiguration 使用 CimSession 参数和存储在 $Session 中的对象来停止配置作业。

参数

-AsJob

指示此 cmdlet 以后台作业的形式运行命令。有关 PowerShell 后台作业的详细信息，请参阅 about_Jobs 和 about_Remote_Jobs。

若要使用 AsJob 参数，必须配置本地计算机和远程计算机进行远程处理。在 Windows Vista 和更高版本的 Windows作系统上，必须使用 以管理员 选项打开 PowerShell。有关详细信息，请参阅 about_Remote_Requirements。

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

-CimSession

在远程会话或远程计算机上运行 cmdlet。输入计算机名或会话对象，例如来自 New-CimSession 或 Get-CimSession的输出。

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

-Confirm

Stop-DscConfiguration 不支持确认参数。如果使用 Confirm 参数，则会显示错误。

对于支持确认的 PowerShell cmdlet，请使用参数提示你在运行命令之前进行验证。

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

-Force

强制命令运行而不要求用户确认。

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

-ThrottleLimit

指定可以建立以运行 cmdlet 的最大并发作数。

如果省略此参数或输入 0 值，PowerShell 会根据计算机上运行的 CIM cmdlet 数计算最佳限制。限制限制仅适用于当前 cmdlet，不适用于会话或计算机。

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

-WhatIf

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

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

输入

None

输出