{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/zh-tw/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"2026/8/3","updated_at_date_time":"2026-08-03T08:21:56.0187226Z"},"_path":"module/configurationmanager/new-cmprogram.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmprogram?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMProgram.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","document_id":"4e0e9eec-bae2-989c-9e13-e8021be3fcca","document_version_independent_id":"a028a2e8-6796-a942-8244-0959506fdd26","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"56bba39258a39caa081f66a0c8b7adbaf406c331","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/56bba39258a39caa081f66a0c8b7adbaf406c331/sccm-ps/ConfigurationManager/New-CMProgram.md","github_contributors":["aczechowski","damabe","sankethka"],"locale":"zh-tw","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"12/28/2021","ms.service":"microsoft-endpoint-configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/New-CMProgram.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMProgram.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"New-CMProgram","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-08-03 08:21 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmprogram","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMProgram","schemaType":"PowershellCmdlet","summary":"

建立套件的新程式。

\n","uid":"ConfigurationManager.New-CMProgram"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMProgram":{"href":"new-cmprogram","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMProgram","schemaType":"PowershellCmdlet","summary":"

建立套件的新程式。

\n","uid":"ConfigurationManager.New-CMProgram"}},"description":"

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

\n
\n

注意事項

\n

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

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

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

\n

此命令會在 Windows 套件的預設用戶狀態移轉工具中建立名為 Scan x64 的程式。

\n","title":"範例 1：建立程式"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"disable-cmprogram","text":"Disable-CMProgram"},{"href":"enable-cmprogram","text":"Enable-CMProgram"},{"href":"get-cmprogram","text":"Get-CMProgram"},{"href":"remove-cmprogram","text":"Remove-CMProgram"},{"href":"set-cmprogram","text":"Set-CMProgram"},{"href":"/mem/configmgr/apps/deploy-use/packages-and-programs","text":"Configuration Manager 中的套件和程式"}],"module":"ConfigurationManager","name":"New-CMProgram","notes":"

如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_Program伺服器 WMI 類別。

\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"AddSupportedOperatingSystemPlatforms","defaultValue":"None","description":"

指定要為程式新增的一或多個支援的OS平臺。 若要取得此物件，請使用 Get-CMSupportedPlatform Cmdlet。

\n","name":"AddSupportedOperatingSystemPlatform","parameterValueGroup":"","position":"Named","type":"

IResultObject[]

\n"},{"aliases":"","defaultValue":"None","description":"

指定程式的命令列。

\n","isRequired":true,"name":"CommandLine","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定包含可執行程序的資料夾。 此資料夾可以是用戶端上的絕對路徑，或是包含套件之散發資料夾的相對路徑。

\n","name":"CommandLineFolder","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定有關程序的選擇性文字，例如描述。 在用戶端電腦上，此文字會與軟體中心的程式一起顯示。

\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"False","description":"

執行 Cmdlet 之前提示您確認。

\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

指定裝置程式名稱。

\n","isRequired":true,"name":"DeviceProgramName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"DiskSpaceReq","defaultValue":"None","description":"

指定軟體程式在計算機上執行所需的磁碟空間量。 值必須大於或等於零。 如果您指定值，請使用 DiskSpaceUnit 參數來指定值的單位。

\n","name":"DiskSpaceRequirement","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

為 DiskSpaceRequirement 參數指定接受的單位。

\n","name":"DiskSpaceUnit","parameterValueGroup":"KB, MB, GB","position":"Named","type":"DiskSpaceUnitType\n"},{"aliases":"","defaultValue":"None","description":"

指定要執行程序的時機。

\n","name":"DownloadProgramType","parameterValueGroup":"AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked","position":"Named","type":"DownloadProgramType\n"},{"aliases":"","defaultValue":"None","description":"

如果您使用 DriveMode 參數，請指定位置的驅動器號。

\n","name":"DriveLetter","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指出程式是否需要 在 DriveLetter 參數中指定的特定驅動器號。

\n\n","name":"DriveMode","parameterValueGroup":"RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter","position":"Named","type":"DriveModeType\n"},{"aliases":"","defaultValue":"None","description":"

指定您預期程式執行的時間上限。 預設值為 120 分鐘。

\n","name":"Duration","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

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

\n","isRequired":true,"name":"PackageId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定此程式的套件名稱。

\n","isRequired":true,"name":"PackageName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定執行程式所需的登入條件。

\n

預設設定為 OnlyWhenUserIsLoggedOn。

\n","name":"ProgramRunType","parameterValueGroup":"OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn","position":"Named","type":"ProgramRunType\n"},{"aliases":"","defaultValue":"None","description":"

指出當使用者登入 Windows 時，用戶端電腦是否重新連線到發佈點。

\n","name":"Reconnect","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"Requirements","defaultValue":"None","description":"

指定標準或裝置程式的其他需求。

\n","name":"Requirement","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定程式在用戶端電腦上執行所需的認證。

\n","name":"RunMode","parameterValueGroup":"RunWithUserRights, RunWithAdministrativeRights","position":"Named","type":"RunModeType\n"},{"aliases":"","defaultValue":"None","description":"

指定程式在用戶端電腦上執行的模式。

\n

預設值為 Normal。

\n","name":"RunType","parameterValueGroup":"Normal, Minimized, Maximized, Hidden","position":"Named","type":"RunType\n"},{"aliases":"","defaultValue":"None","description":"

指定標準程式名稱。

\n","isRequired":true,"name":"StandardProgramName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指出是否允許使用者與程序互動。

\n","name":"UserInteraction","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"wi","defaultValue":"False","description":"

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

指定程式的工作目錄。

\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"

建立套件的新程式。

\n","syntaxes":["New-CMProgram [-AddSupportedOperatingSystemPlatform ] -CommandLine \n [-DiskSpaceRequirement ] [-DiskSpaceUnit ] [-DriveLetter ]\n [-DriveMode ] [-Duration ] -PackageName [-ProgramRunType ]\n [-Reconnect ] [-RunMode ] [-RunType ] -StandardProgramName \n [-UserInteraction ] [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] []","New-CMProgram [-AddSupportedOperatingSystemPlatform ] -CommandLine \n [-DiskSpaceRequirement ] [-DiskSpaceUnit ] [-DriveLetter ]\n [-DriveMode ] [-Duration ] -PackageId [-ProgramRunType ]\n [-Reconnect ] [-RunMode ] [-RunType ] -StandardProgramName \n [-UserInteraction ] [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] []","New-CMProgram -CommandLine [-CommandLineFolder ] [-Comment ]\n -DeviceProgramName [-DiskSpaceRequirement ] [-DiskSpaceUnit ]\n [-DownloadProgramType ] -PackageName [-Requirement ]\n [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []","New-CMProgram -CommandLine [-CommandLineFolder ] [-Comment ]\n -DeviceProgramName [-DiskSpaceRequirement ] [-DiskSpaceUnit ]\n [-DownloadProgramType ] -PackageId [-Requirement ]\n [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []"],"uid":"ConfigurationManager.New-CMProgram","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"zh-tw","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMProgram.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmprogram","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMProgram","schemaType":"PowershellCmdlet","summary":"

建立套件的新程式。

\n","uid":"ConfigurationManager.New-CMProgram"}],"canonical_url":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmprogram?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmprogram?view=sccm-ps"},"pageMetadata":"使用此 Cmdlet 建立封裝的程式。\n程式是與 Configuration Manager 套件相關聯的命令。\n它們會識別用戶端接收用戶端套件時所發生的動作。\n您可以將多個程式與相同的套件產生關聯。\n如需詳細資訊，請參閱 Configuration Manager 中的套件和程式。

\n
\n

注意事項

\n

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

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_Program伺服器 WMI 類別。

\n\" />\r\n\r\n建立套件的新程式。

\n\" />\r\n] -CommandLine \n [-DiskSpaceRequirement ] [-DiskSpaceUnit ] [-DriveLetter ]\n [-DriveMode ] [-Duration ] -PackageName [-ProgramRunType ]\n [-Reconnect ] [-RunMode ] [-RunType ] -StandardProgramName \n [-UserInteraction ] [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] []\" />\r\n] -CommandLine \n [-DiskSpaceRequirement ] [-DiskSpaceUnit ] [-DriveLetter ]\n [-DriveMode ] [-Duration ] -PackageId [-ProgramRunType ]\n [-Reconnect ] [-RunMode ] [-RunType ] -StandardProgramName \n [-UserInteraction ] [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] []\" />\r\n [-CommandLineFolder ] [-Comment ]\n -DeviceProgramName [-DiskSpaceRequirement ] [-DiskSpaceUnit ]\n [-DownloadProgramType ] -PackageName [-Requirement ]\n [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []\" />\r\n [-CommandLineFolder ] [-Comment ]\n -DeviceProgramName [-DiskSpaceRequirement ] [-DiskSpaceUnit ]\n [-DownloadProgramType ] -PackageId [-Requirement ]\n [-WorkingDirectory ] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n []\" />\r\n\r\n","themesRelativePathToOutputRoot":"_themes/"}