Stop-DscConfiguration

  • 参考
模块:
PSDesiredStateConfiguration

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

语法

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

说明

cmdlet Stop-DscConfiguration 停止正在运行的配置作业。 使用通用信息模型 (CIM) 会话指定应用此 cmdlet 的计算机。 如果没有正在运行的配置作业，此 cmdlet 将返回警告消息。

Stop-DscConfiguration仅作为 2014 年 11 月更新汇总的一部分提供，适用于来自 Microsoft 支持部门 库的 Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R2。 使用此 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。

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

-CimSession

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

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

-Confirm

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

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

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

-Force

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

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

-ThrottleLimit

指定可为运行 cmdlet 而确立的操作的最大数量。

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

Type:Int32
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

输入

None

输出

None