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>]

Description

使用此 Cmdlet 建立封裝的程式。 程式是與 Configuration Manager 套件相關聯的命令。 它們會識別用戶端接收用戶端套件時所發生的動作。 您可以將多個程式與相同的套件產生關聯。 如需詳細資訊，請參閱 Configuration Manager 中的套件和程式。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：建立程式

此範 例會先 將 Cmdlet 參數展開至 parameters 變數。 不一定需要套用參數，只要讓您更輕鬆地讀取這麼長命令行的參數即可。

此命令會在 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

指定此程式的套件識別碼。

類型:	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 中的套件和程式