Set-CMProgram

模块:

ConfigurationManager

修改程序包的程序。

语法

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -PackageName <String>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -PackageId <String>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -InputObject <IResultObject>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 可以修改程序包的程序。 程序标识客户端接收客户端程序包时发生的操作。 你可以将多个程序与同一个程序包关联。 有关详细信息，请参阅 Configuration Manager 中的程序包和程序。

备注

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

示例

示例 1：修改标准程序

Set-CMProgram -Name "Test" -StandardProgramName SPM -Comment "Standard Upgrades" -CommandLine "RunThisNow" -RunType Maximized -AfterRunningType ProgramControlsRestart -Category "Laptops" -DiskSpaceRequirement 50 -DiskSpaceUnit MB -Duration 150 -Requirement 4 -Reconnect $False -SuppressProgramNotifications $False -DisableProgram $True -EnableTaskSequence $True -DisableMomAlertOnRun $True -GenerateMomAlertOnFail $True

示例 2：修改设备程序

Set-CMProgram -Name "Test" -DeviceProgramName DPM -Comment "Upgrades for December" -CommandLine "RunMe" -WorkingDirectory "\TempWork" -CommandLineFolder "C:\Windows" -DiskSpaceRequirement 30 -DiskSpaceUnit MB -DownloadProgramType AsSoonAsPossible -Requirement "All previous device updates"

示例 3：添加受支持的操作系统平台

此示例设置与标准程序包关联的程序的操作系统要求。 它使用 Get-CMSupportedPlatform cmdlet 获取指定平台的对象。 然后，它使用此受支持的平台对象来配置程序。

$ProgramName = 'Script'
$PackageID = 'XYZ0000D'
$Platform = 'All Windows 10 (64-bit) Client'
$OS = Get-CMSupportedPlatform -Name $Platform -Fast

Set-CMProgram -PackageID $PackageID -ProgramName $ProgramName -AddSupportedOperatingSystemPlatform $OS -StandardProgram

参数

-AddSupportedOperatingSystemPlatform

指定要为计划添加的一个或多个受支持的操作系统平台。 若要获取此对象，请使用 Get-CMSupportedPlatform cmdlet。

Type:	IResultObject[]
Aliases:	AddSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AfterRunningType

指定在程序成功完成后发生的操作。

Type:	AfterRunningType
Accepted values:	NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Category

指定在客户端计算机上显示程序所基于的类别。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandLine

指定程序的命令行。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandLineFolder

指定包含可执行程序的文件夹。 此文件夹可以是客户端上的绝对路径或相对于包含程序包的分发文件夹的路径。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

指定有关程序的可选文本，如说明。 在客户端计算机上，此文本与软件中心中的程序一起显示。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

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

-DeviceProgram

添加此参数以将此程序配置为设备程序。

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

-DisableMomAlertOnRun

指示运行程序的计算机在程序持续时间内是否位于维护模式下。 当在维护模式下System Center，Operations Manager 会禁用程序运行时的警报。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableProgram

将此参数 $true 设置为 以暂时禁用包含此程序的所有部署。 您还可以使用 Disable-CMProgram cmdlet。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-DiskSpaceRequirement

指定软件程序在计算机上运行所需的磁盘空间量。 该值必须大于或等于零。 如果指定值，请使用 DiskSpaceUnit 参数指定该值的单位。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskSpaceUnit

指定 DiskSpaceRequirement 参数的接受 单位。

Type:	DiskSpaceUnitType
Accepted values:	KB, MB, GB
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DownloadProgramType

指定程序何时运行。

Type:	DownloadProgramType
Accepted values:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DriveLetter

如果使用 DriveMode 参数，请指定位置的驱动器号。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DriveMode

指示程序是否需要在 DriveLetter 参数中指定的特定驱动器号。

• RunWithUnc：从 UNC 路径运行程序。 此值为默认值。 从版本 2010 开始，此值从 RenameWithUnc 重命名。

• RequiresDriveLetter：程序使用任何可用的驱动器号。

• RequiresSpecificDriveLetter：程序仅在驱动器尚未使用时运行。

Type:	DriveModeType
Accepted values:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Duration

指定预计程序运行的最大时间量。 默认值为 120 分钟。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableTaskSequence

指示是否可以从安装程序包任务序列 步骤安装此 程序。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

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

-GenerateMomAlertOnFail

指示程序失败时 Configuration Manager 是否生成应用程序日志事件条目。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	ProgramPackage, Package, Program
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PackageId

使用要配置的程序指定程序包 ID。

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageName

使用要配置的程序指定程序包名称。

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

返回一个对象，该对象代表正在处理的项目。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-ProgramAssignedType

指定程序是在计算机上运行一次，还是对登录计算机的每个用户运行一次。 默认值为 RunOnceForTheComputer。 程序仅在 ProgramRunType 参数设置为 时分配给用户 OnlyWhenUserIsLoggedOn 。

Type:	ProgramAssignedType
Accepted values:	RunOnceForTheComputer, RunOnceForEveryUserWhoLogsOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramName

指定要配置的程序的名称。

Type:	String
Aliases:	StandardProgramName, DeviceProgramName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramRunType

指定程序运行所需的登录条件。 默认值为 OnlyWhenUserIsLoggedOn。

Type:	ProgramRunType
Accepted values:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Reconnect

指示用户登录时客户端计算机是否重新连接到分发点。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSupportedOperatingSystemPlatform

指定要为此程序删除的一个或多个受支持的操作系统平台。 若要获取此对象，请使用 Get-CMSupportedPlatform cmdlet。

Type:	IResultObject[]
Aliases:	RemoveSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Requirement

指定标准程序或设备程序的其他要求。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunMode

指定客户端计算机运行程序所需的凭据。

Type:	RunModeType
Accepted values:	RunWithUserRights, RunWithAdministrativeRights
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunOnAnyPlatform

添加此参数以从此计划清除所有受支持的操作系统平台。

Type:	SwitchParameter
Aliases:	ClearSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunType

指定程序在客户端计算机上运行的模式。 默认值为 Normal。

Type:	RunType
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StandardProgram

指示部署包中的程序类型是标准程序。

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

-SuppressProgramNotification

设置此参数 $true 可禁止程序通知。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserInteraction

指示是否允许用户与程序交互。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

-WorkingDirectory

指定程序的工作目录。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Disable-CMProgram
• Enable-CMProgram
• Get-CMProgram
• New-CMProgram
• Remove-CMProgram
• Configuration Manager 中的程序包和程序