New-CMOperatingSystemImage
建立OS映像。
語法
New-CMOperatingSystemImage
[-Description <String>]
-Name <String>
-Path <String>
[-Index <Int32>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 將 OS 映射新增至 Configuration Manager 月臺。 OS 映像是 WIM 檔案，代表參考檔案和資料夾的壓縮集合。 Configuration Manager 會使用這些映像搭配工作順序，在計算機上部署 OS。 如需詳細資訊，請 參閱使用 Configuration Manager 管理 OS 映射。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：建立 OS 映射
此命令會從OS映像安裝來源檔案的網路路徑建立名為 「Windows 10 latest」 的 OS 映像。
New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"參數
-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 |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Path
指定 OS 映像 WIM 檔案的網路路徑。 路徑必須包含擴展名的 .wim WIM 檔名。
| 類型: | 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_ImagePackage伺服器 WMI 類別。