New-CMOperatingSystemInstaller
建立 OS 升級套件。
Syntax
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 安裝來源檔案，可升級電腦上的現有作業系統。 如需詳細資訊，請參閱 使用 Configuration Manager 管理 OS 升級套件。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例1：新增作業系統升級套件
這個命令會將名為 Windows 10 的 OS 升級套件新增至最新，並指定安裝來源檔案的網路路徑。
New-CMOperatingSystemInstaller -Name "Windows 10 latest" -Path "\\Contoso01\CM\Win10latest"參數
-Confirm
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定選用的描述，以協助您識別升級套件。 最大長度為127個字元。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定 OS 升級套件來源檔案的網路路徑。 安裝來源檔案包含 setup.exe 及其他檔案和資料夾，以安裝作業系統。
| Type: | String |
| Aliases: | PackageSourcePath |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名稱
指定 OS 升級套件的名稱。 最大長度為50個字元。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-版本
指定 OS 映射的選用版本。 此值是針對您的內部版本設定，而非作業系統的版本。 最大長度為32個字元。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-索引
當您新增此參數時，網站會從多索引影像解壓縮單一索引影像。 然後，它會將新的映射放在升級套件來源檔案中的原始映射所在的來源資料夾中。
使用此選項會產生較小的影像檔及更快的離線服務。 在套用軟體更新之後，它還支援 優化影像服務的程式，以取得較小的影像檔。
| Type: | Int32 |
| Aliases: | ImageIndex |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
無
輸出
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊，請參閱 SMS_OperatingSystemInstallPackage SERVER WMI 類別。