New-CMProgram

模块:

ConfigurationManager

为包创建新程序。

语法

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageId <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 为包创建程序。 程序是与 Configuration Manager 包关联的命令。 它们标识客户端收到客户端包时发生的操作。 可以将多个程序与同一个包相关联。 有关详细信息，请参阅 Configuration Manager 中的包和程序。

注意

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

示例

示例 1：创建程序

此示例首先将 cmdlet 参数 Splats 到 parameters 变量中。 不需要对参数进行 splat，它只是便于读取如此长的命令行的参数。

此命令在 Windows 的默认用户状态迁移工具包中创建名为 Scan x64 的程序。

$parameters = @{
  PackageName = "User State Migration Tool for Windows"
  StandardProgramName = "Scan x64"
  CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
  RunType = "Normal"
  ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
  DiskSpaceRequirement = 200
  DiskSpaceUnit = "MB"
  Duration = 100
  DriveMode = "RunWithUnc"
}
New-CMProgram @parameters

参数

-AddSupportedOperatingSystemPlatform

指定要为程序添加的一个或多个受支持的 OS 平台。 若要获取此对象，请使用 Get-CMSupportedPlatform cmdlet。

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

-CommandLine

指定程序的命令行。

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

-CommandLineFolder

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

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

-Comment

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

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

-Confirm

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

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

-DeviceProgramName

指定设备程序名称。

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

-DisableWildcardHandling

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

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

-DiskSpaceRequirement

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

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

-DiskSpaceUnit

为 DiskSpaceRequirement 参数指定接受的单位。

类型:	DiskSpaceUnitType
接受的值:	KB, MB, GB
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DownloadProgramType

指定程序何时运行。

类型:	DownloadProgramType
接受的值:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriveLetter

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

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

-DriveMode

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

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

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

• RequiresSpecificDriveLetter：仅当驱动器尚未使用时，程序才会运行。

类型:	DriveModeType
接受的值:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Duration

指定预期程序运行的最长时间。 默认值为 120 分钟。

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

-ForceWildcardHandling

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

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

-PackageId

指定此程序的包 ID。

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

-PackageName

指定此程序的包名称。

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

-ProgramRunType

指定程序运行所需的登录条件。

默认设置为 OnlyWhenUserIsLoggedOn。

类型:	ProgramRunType
接受的值:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Reconnect

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

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

-Requirement

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

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

-RunMode

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

类型:	RunModeType
接受的值:	RunWithUserRights, RunWithAdministrativeRights
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RunType

指定程序在客户端计算机上运行的模式。

默认值为 Normal。

类型:	RunType
接受的值:	Normal, Minimized, Maximized, Hidden
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StandardProgramName

指定标准程序名称。

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

-UserInteraction

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

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

-WhatIf

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

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

-WorkingDirectory

指定程序的工作目录。

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

输入

None

输出

IResultObject

备注

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

相关链接

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