New-CMOperatingSystemInstaller
建立 OS 升級套件。
語法
New-CMOperatingSystemInstaller
[-Description <String>]
[-Name <String>]
[-Index <Int32>]
-Path <String>
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 將 OS 升級套件新增至 Configuration Manager 月臺。 Configuration Manager 中的 OS 升級套件包含 Windows 安裝程式來源檔案，可升級電腦上的現有 OS。 如需詳細資訊，請 參閱使用 Configuration Manager 管理 OS 升級套件。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：新增 OS 升級套件
此命令會新增名為 Windows 10 latest 的 OS 升級套件，並指定安裝來源檔案的網路路徑。
New-CMOperatingSystemInstaller -Name "Windows 10 latest" -Path "\\Contoso01\CM\Win10latest"參數
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定選擇性的描述，以協助您識別升級套件。 最大長度為 127 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Index
當您新增此參數時，月臺會從多重索引映射擷取單一索引映射。 然後，它會將新映射放在與升級套件來源檔案中原始映射相同的來源資料夾中。
使用此選項會產生較小的圖像檔案，並加快離線服務的速度。 它也支援在套用軟體更新之後，針對較小的圖像檔 案優化映射服務的程式。
| 類型: | Int32 |
| 別名: | ImageIndex |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 OS 升級套件的名稱。 最大長度為 50 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Path
指定 OS 升級套件來源檔案的網路路徑。 安裝來源檔案包含 setup.exe 和其他檔案和資料夾，以安裝OS。
| 類型: | String |
| 別名: | PackageSourcePath |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Version
指定 OS 映像的選擇性版本。 此值適用於您的內部版本設定，而非操作系統版本。 最大長度為 32 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_OperatingSystemInstallPackage伺服器 WMI 類別。