通过

Disable-CMProgram

  • 参考
模块:
ConfigurationManager

禁用包中的程序。

语法

Disable-CMProgram
       -InputObject <IResultObject>
       [-PassThru]
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageId <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageName <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

说明

使用此 cmdlet 禁用包中的程序。

禁用程序以防止 Configuration Manager 客户端运行该程序。 禁用程序时，Configuration Manager 仍会将包内容分发到分发点，并将程序部署发送到客户端。 客户端不会在客户端上显示或运行程序。 禁用程序部署时，此行为相同。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：禁用程序

此命令在 ID 为 XYZ00007 的包中禁用名为 ProgramD02 的程序。

Disable-CMProgram -PackageId "XYZ00007" -ProgramName "ProgramD02"

参数

-Confirm

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

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

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

-InputObject

指定要禁用的程序对象。 若要获取此对象，请使用 Get-CMProgram cmdlet。

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

-PackageId

指定要禁用的程序的包的 ID。

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

-PackageName

指定要禁用的程序的包的名称。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-ProgramName

指定要禁用的程序的包的名称。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_Program服务器 WMI 类。