共用方式為


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