Stop-DscConfiguration
停止正在运行的配置作业。
语法
All
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Stop-DscConfiguration cmdlet 停止正在运行的配置作业。 使用 Common Information Model （CIM） 会话指定此 cmdlet 适用的计算机。 如果没有运行配置作业，此 cmdlet 将返回警告消息。
Stop-DscConfiguration 仅在 2014 年 11 月 2014 年 11 月 Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R 2 更新汇总的一部分提供，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 |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CimSession
在远程会话或远程计算机上运行 cmdlet。 输入计算机名或会话对象，例如来自 New-CimSession 或 Get-CimSession的输出。
参数属性
| 类型: | |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 会话 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
Stop-DscConfiguration 不支持 确认 参数。 如果使用 Confirm 参数，则会显示错误。
对于支持 确认的 PowerShell cmdlet，请使用参数提示你在运行命令之前进行验证。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
强制命令运行而不要求用户确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ThrottleLimit
指定可以建立以运行 cmdlet 的最大并发操作数。
如果省略此参数或输入 0 值，PowerShell 会根据计算机上运行的 CIM cmdlet 数计算最佳限制。 限制限制仅适用于当前 cmdlet，不适用于会话或计算机。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
