New-CMPrestageMedia
建立OS部署預先設置的媒體檔案。
語法
New-CMPrestageMedia
[-Application <IResultObject[]>]
[-Comment <String>]
[-CreatedBy <String>]
[-DriverPackage <IResultObject[]>]
[-IncludeApplicationDependency]
-OperatingSystemImage <IResultObject>
[-OperatingSystemImageIndex <Int32>]
[-Package <IResultObject[]>]
-TaskSequence <IResultObject>
[-Version <String>]
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-CMPrestageMedia Cmdlet 會建立檔案,以在新硬碟上預先設置 OS 映射。 如需詳細資訊,請參閱 規劃預先設置的媒體。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:建立預先設置的媒體
第一個命令會取得月臺碼 CM1 中名為 mp01.contoso.com 之月台系統伺服器的管理點物件,並將物件儲存在 $ManagementPoint 變數中。
第二個命令會取得名為 BootImage01 的開 機映射物件,並將物件儲存在 $BootImage 變數中。
第三個命令會取得月臺碼 CM1 中名為 dist01.contoso.com 之月台系統伺服器的發佈點物件,並將物件儲存在 $DistributionPoint 變數中。
第四個命令會取得名為 OSImagePkg01的OS映 射物件,並將物件儲存在 $OSImage 變數中。
最後一個命令會建立名為 PrestagedMedia.wim 的動態預先設置媒體檔案,其開機映射會儲存在 $BootImage、發佈點儲存在 $DistributionPoint、管理點儲存在 $ManagementPoint 中,以及儲存在 $OSImage 中的 OS 映射。
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"
New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage
參數
-AllowUacPrompt
新增此參數,讓 Windows 提示您使用使用者帳戶控制 (UAC) 提高系統管理員許可權。 此 Cmdlet 需要較高的許可權才能執行。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AllowUnattended
新增此參數以允許自動作業系統部署。 自動作業系統部署不會提示您輸入網路設定或選擇性工作順序。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AllowUnknownMachine
新增此參數以允許 Configuration Manager 布建未知的電腦。 未知的電腦是月臺尚未探索到的計算機。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Application
指定要包含為媒體檔案一部分的應用程式物件數位。 如果工作順序參考此內容,它會先在本機尋找內容。 如果內容不在媒體中,工作順序會嘗試如常從網路下載內容。 若要取得應用程式物件,請使用 Get-CMApplication Cmdlet。
類型: | IResultObject[] |
別名: | Applications |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-BootImage
指定開機映像物件。 若要取得此物件,請使用 Get-CMBootImage Cmdlet。
類型: | IResultObject |
別名: | BootImagePackage |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-CertificateExpireTime
如果您為 HTTP 通訊建立自我簽署媒體憑證,此參數會指定憑證的到期日期和時間。 在未來有足夠的時間指定日期時間。 當此憑證過期時,您無法使用可開機媒體。 使用 -CertificateStartTime 參數來設定開始日期。
例如:
$date = [datetime]::p arseexact (“11/16/2021”, 'MM/dd/yyyy', $null)
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CertificatePassword
如果您使用 -CertificatePath 參數匯入 PKI 憑證以進行 HTTPS 通訊,請使用此參數來指定憑證檔案的密碼。
類型: | SecureString |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CertificatePath
指定要匯入之 PKI 憑證的路徑。 使用 -CertificatePassword 參數來指定此憑證檔案的密碼。 如果您設定月臺以進行 HTTPS 用戶端通訊,請使用這些參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CertificateStartTime
若要建立用於 HTTP 通訊的自我簽署憑證,此參數會指定憑證的開始日期和時間。 使用 -CertificateExpireTime 參數來設定到期日。 在此日期之前,您無法使用可開機媒體。
例如:
$date = [datetime]::p arseexact (“11/16/2020”, 'MM/dd/yyyy', $null)
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Comment
選擇性字串,可提供媒體的進一步詳細數據。 描述您的設定方式或如何使用此媒體很有用。 最大長度為 127 個字元。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CreatedBy
指定建立此媒體之人員的選擇性字串,適用於追蹤用途。 最大長度為 50 個字元。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DistributionPoint
指定一或多個發佈點物件,以供您發佈此媒體的內容。 若要取得此物件,請使用 Get-CMDistributionPoint Cmdlet。
類型: | IResultObject[] |
別名: | DistributionPoints |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-DriverPackage
指定要包含在媒體檔案中的驅動程式套件物件數位。 如果工作順序參考此內容,它會在本機尋找內容。 如果內容不在媒體中,工作順序會嘗試如常從網路下載內容。 若要取得此物件,請使用 Get-CMDriverPackage Cmdlet。
類型: | IResultObject[] |
別名: | DriverPackages, PackageDriver, PackageDrivers |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
執行命令而不要求確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeApplicationDependency
新增此參數以偵測相關聯的應用程式相依性,並將其新增至此媒體。
類型: | SwitchParameter |
別名: | IncludeApplicationDependencies |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ManagementPoint
指定媒體在初始通訊中使用的一或多個管理點物件。 使用 -MediaMode 參數來判斷媒體在執行時的通訊方式。 若要取得此物件,請使用 Get-CMManagementPoint Cmdlet。
類型: | IResultObject[] |
別名: | ManagementPoints |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-MediaMode
指定客戶端尋找管理點以取得部署資訊的方式:
Dynamic
:媒體會連絡管理點,該管理點會根據月臺界限中的用戶端位置,將用戶端重新導向至不同的管理點。SiteBased
:媒體會傳達使用 -ManagementPoint 參數指定的管理點。
類型: | MediaMode |
接受的值: | Dynamic, SiteBased |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-MediaPassword
指定安全字串密碼來保護工作順序媒體。 當您使用此媒體開機裝置時,必須輸入密碼才能繼續。
類型: | SecureString |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NoAutoRun
新增此參數以在媒體上包含 autorun.inf 檔案。 Configuration Manager 預設不會新增它。 反惡意代碼產品通常會封鎖此檔案。 如需 Windows 自動執行功能的詳細資訊,請參閱 建立已啟用 AutoRun 的 CD-ROM 應用程式。 如果您的案例仍然需要,請新增此參數以包含 檔案。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-OperatingSystemImage
指定要包含此媒體的OS映像套件物件。 使用 OperatingSystemImageIndex 參數來指定映射套件中的映射索引。 若要取得此物件,請使用 Get-CMOperatingSystemImage Cmdlet。
類型: | IResultObject |
別名: | OperatingSystemImagePackage |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-OperatingSystemImageIndex
從 OperatingSystemImage 參數指定映像套件中的映射索引。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Package
指定要包含在媒體檔案中的封裝物件數位。 如果工作順序參考此內容,它會在本機尋找內容。 如果內容不在媒體中,工作順序會嘗試如常從網路下載內容。 若要取得此物件,請使用 Get-CMPackage Cmdlet。
類型: | IResultObject[] |
別名: | Packages |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
要建立之媒體檔案的路徑。 格式為磁碟驅動器/目錄路徑或有效的網路路徑。 例如:
C:\media\prestaged1.wim
\\server\share\prestaged1.wim
類型: | String |
別名: | MediaPath, OutputPath, DriveName |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-PrestartCommand
指定要在工作順序開始之前執行的命令行。 如需詳細資訊,請 參閱工作順序媒體的啟動前置命令。
類型: | String |
別名: | PreExecCommandLine |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PrestartPackage
如果您指定 PrestartCommand,請視需要使用此參數來指定啟動前置內容的套件。
類型: | IResultObject |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SiteCode
適用於 2010 版和更新版本。 使用此參數搭配 ManagementPoint 參數來指定月臺碼。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-TaskSequence
指定要執行此媒體的工作順序物件。 若要取得此物件,請使用 Get-CMTaskSequence Cmdlet。
類型: | IResultObject |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-TemporaryFolder
媒體建立程式可能需要大量的暫存磁碟驅動器空間。 根據預設,Configuration Manager 會使用目前使用者的暫存目錄: $env:temp
。 例如,C:\Users\jqpublic\AppData\Local\Temp\
。 若要讓您更靈活地儲存這些臨時檔,請指定預備暫存數據的自定義位置。
類型: | String |
別名: | TemporaryDirectory, StagingArea |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UserDeviceAffinity
若要在 Configuration Manager 中支援以使用者為中心的管理,請指定媒體如何讓使用者與目的地計算機產生關聯。 如需OS部署如何支援使用者裝置親和性的詳細資訊,請參閱 將使用者與目的地電腦建立關聯。
DoNotAllow
:不允許使用者裝置親和性。 媒體不會將使用者與目的地計算機產生關聯。 在此案例中,工作順序不會在部署OS時將使用者與目的地計算機產生關聯。AdministratorApproval
:允許使用者裝置親和性等待系統管理員核准。 媒體會在您核准核准之後,將使用者與目的地計算機產生關聯。 這項功能是以部署 OS 的工作順序範圍為基礎。 在此案例中,工作順序會在指定的使用者與目的地計算機之間建立關聯性。 然後,它會等候系統管理使用者核准,然後再部署OS。AutoApproval
:允許自動核准使用者裝置親和性。 媒體會自動將使用者與目的地計算機產生關聯。 這項功能是以部署 OS 之工作順序的動作為基礎。 在此案例中,工作順序會在將OS部署至目的地計算機時,在指定的使用者和目的地計算機之間建立關聯性。
類型: | UserDeviceAffinityType |
接受的值: | DoNotAllow, AdministratorApproval, AutoApproval |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Variable
從此媒體指定工作順序部署期間要使用的工作順序變數哈希表。
類型: | Hashtable |
別名: | TaskSequenceVariables, Variables |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Version
指定此媒體版本的選擇性字串值,適用於追蹤和修訂用途。 最大長度為 32 個字元。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
System.Object
備註
Cmdlet 別名: New-CMPrestagedMedia