New-CMProgram
为包创建新程序。
语法
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。
| Type: | IResultObject[] |
| Aliases: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandLine
指定程序的命令行。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandLineFolder
指定包含可执行程序的文件夹。 此文件夹可以是客户端上的绝对路径，也可以是相对于包含包的分发文件夹的路径。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Comment
指定有关程序的可选文本，例如说明。 在客户端计算机上，此文本与软件中心中的程序一起显示。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
指定设备程序名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSpaceRequirement
指定软件程序在计算机上运行所需的磁盘空间量。 该值必须大于或等于零。 如果指定值，请使用 DiskSpaceUnit 参数指定该值的单位。
| Type: | String |
| Aliases: | DiskSpaceReq |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSpaceUnit
为 DiskSpaceRequirement 参数指定接受的单位。
| Type: | DiskSpaceUnitType |
| Accepted values: | KB, MB, GB |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DownloadProgramType
指定程序何时运行。
| Type: | DownloadProgramType |
| Accepted values: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriveLetter
如果使用 DriveMode 参数，请为位置指定驱动器号。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Duration
指定预期程序运行的最长时间。 默认值为 120 分钟。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
指定此程序的包 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
指定此程序的包名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgramRunType
指定程序运行所需的登录条件。
默认设置为 OnlyWhenUserIsLoggedOn。
| Type: | ProgramRunType |
| Accepted values: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reconnect
指示当用户登录到 Windows 时客户端计算机是否重新连接到分发点。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Requirement
指定标准程序或设备程序的其他要求。
| Type: | String |
| Aliases: | Requirements |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunMode
指定程序在客户端计算机上运行所需的凭据。
| Type: | RunModeType |
| Accepted values: | RunWithUserRights, RunWithAdministrativeRights |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunType
指定程序在客户端计算机上运行的模式。
默认值为 Normal。
| Type: | RunType |
| Accepted values: | Normal, Minimized, Maximized, Hidden |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
指定标准程序名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserInteraction
指示是否允许用户与程序交互。
| Type: | Boolean |
| 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 |
-WorkingDirectory
指定程序的工作目录。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
None
输出
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_Program服务器 WMI 类。
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈