共用方式為

New-CMPrestageMedia

  • 參考
模組:
ConfigurationManager

建立 OS 部署預先設置的媒體檔案。

Syntax

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 需要較高的許可權才能執行。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUnattended

新增此參數以允許自動作業系統部署。 自動作業系統部署不會提示您輸入網路設定或選擇性工作順序。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUnknownMachine

新增此參數以允許Configuration Manager布建未知的電腦。 未知的電腦是月臺尚未探索到的電腦。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Application

指定要包含為媒體檔案一部分的應用程式物件陣列。 如果工作順序參考此內容，它會先在本機尋找內容。 如果內容不在媒體中，工作順序會嘗試如常從網路下載內容。 若要取得應用程式物件，請使用 Get-CMApplication Cmdlet。

Type:IResultObject[]
Aliases:Applications
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BootImage

指定開機映射物件。 若要取得此物件，請使用 Get-CMBootImage Cmdlet。

Type:IResultObject
Aliases:BootImagePackage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificateExpireTime

如果您為 HTTP 通訊建立自我簽署媒體憑證，此參數會指定憑證的到期日期和時間。 在未來有足夠的時間指定日期時間。 當此憑證過期時，您無法使用可開機媒體。 使用 -CertificateStartTime 參數來設定開始日期。

例如：

$date = [datetime]：:p arseexact (「11/16/2021」， 'MM/dd/yyyy'， $null)

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

如果您使用 -CertificatePath 參數匯入 PKI 憑證以進行 HTTPS 通訊，請使用此參數來指定憑證檔案的密碼。

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePath

指定要匯入之 PKI 憑證的路徑。 使用 -CertificatePassword 參數來指定此憑證檔案的密碼。 如果您設定月臺以進行 HTTPS 用戶端通訊，請使用這些參數。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateStartTime

若要建立用於 HTTP 通訊的自我簽署憑證，此參數會指定憑證的開始日期和時間。 使用 -CertificateExpireTime 參數來設定到期日。 在此日期之前，您無法使用可開機媒體。

例如：

$date = [datetime]：:p arseexact (「11/16/2020」， 'MM/dd/yyyy'， $null)

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Comment

選擇性字串，可提供媒體的進一步詳細資料。 描述您的設定方式或如何使用此媒體很有用。 最大長度為 127 個字元。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreatedBy

指定建立此媒體之人員的選擇性字串，適用于追蹤用途。 最大長度為 50 個字元。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPoint

指定一或多個發佈點物件，以供您發佈此媒體的內容。 若要取得此物件，請使用 Get-CMDistributionPoint Cmdlet。

Type:IResultObject[]
Aliases:DistributionPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DriverPackage

指定要包含在媒體檔案中的驅動程式套件物件陣列。 如果工作順序參考此內容，它會在本機尋找內容。 如果內容不在媒體中，工作順序會嘗試如常從網路下載內容。 若要取得此物件，請使用 Get-CMDriverPackage Cmdlet。

Type:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

執行命令而不要求確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeApplicationDependency

新增此參數以偵測相關聯的應用程式相依性，並將其新增至此媒體。

Type:SwitchParameter
Aliases:IncludeApplicationDependencies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementPoint

指定媒體在初始通訊中使用的一或多個管理點物件。 使用 -MediaMode 參數來判斷媒體在執行時的通訊方式。 若要取得此物件，請使用 Get-CMManagementPoint Cmdlet。

Type:IResultObject[]
Aliases:ManagementPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaMode

指定用戶端尋找管理點以取得部署資訊的方式：

  • Dynamic：媒體會連絡管理點，該管理點會根據月臺界限中的用戶端位置，將用戶端重新導向至不同的管理點。

  • SiteBased：媒體會傳達使用 -ManagementPoint 參數指定的管理點。

Type:MediaMode
Accepted values:Dynamic, SiteBased
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaPassword

指定安全字串密碼來保護工作順序媒體。 當您使用此媒體開機裝置時，必須輸入密碼才能繼續。

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoAutoRun

新增此參數以在媒體上包含 autorun.inf 檔案。 Configuration Manager預設不會新增它。 反惡意程式碼產品通常會封鎖此檔案。 如需 Windows 自動執行功能的詳細資訊，請參閱 建立已啟用 AutoRun 的 CD-ROM 應用程式。 如果您的案例仍然需要，請新增此參數以包含 檔案。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImage

指定要包含此媒體的 OS 映射套件物件。 使用 OperatingSystemImageIndex 參數來指定映射套件中的映射索引。 若要取得此物件，請使用 Get-CMOperatingSystemImage Cmdlet。

Type:IResultObject
Aliases:OperatingSystemImagePackage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImageIndex

從 OperatingSystemImage 參數指定映射套件中的映射索引。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Package

指定要包含在媒體檔案中的封裝物件陣列。 如果工作順序參考此內容，它會在本機尋找內容。 如果內容不在媒體中，工作順序會嘗試如常從網路下載內容。 若要取得此物件，請使用 Get-CMPackage Cmdlet。

Type:IResultObject[]
Aliases:Packages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

要建立之媒體檔案的路徑。 格式為磁片磁碟機/目錄路徑或有效的網路路徑。 例如：

  • C:\media\prestaged1.wim
  • \\server\share\prestaged1.wim
Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrestartCommand

指定要在工作順序開始之前執行的命令列。 如需詳細資訊，請 參閱工作順序媒體的啟動前置命令。

Type:String
Aliases:PreExecCommandLine
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrestartPackage

如果您指定 PrestartCommand，請視需要使用此參數來指定啟動前置內容的套件。

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

適用于 2010 版和更新版本。 使用此參數搭配 ManagementPoint 參數來指定月臺碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequence

指定要執行此媒體的工作順序物件。 若要取得此物件，請使用 Get-CMTaskSequence Cmdlet。

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryFolder

媒體建立程式可能需要大量的暫存磁片磁碟機空間。 根據預設，Configuration Manager使用目前使用者的臨時目錄： $env:temp 。 例如，C:\Users\jqpublic\AppData\Local\Temp\。 若要讓您更靈活地儲存這些暫存檔案，請指定預備暫存資料的自訂位置。

Type:String
Aliases:TemporaryDirectory, StagingArea
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserDeviceAffinity

若要在Configuration Manager中支援以使用者為中心的管理，請指定媒體如何讓使用者與目的地電腦產生關聯。 如需 OS 部署如何支援使用者裝置親和性的詳細資訊，請參閱 將使用者與目的地電腦建立關聯。

  • DoNotAllow：不允許使用者裝置親和性。 媒體不會將使用者與目的地電腦產生關聯。 在此案例中，工作順序不會在部署 OS 時將使用者與目的地電腦產生關聯。

  • AdministratorApproval：允許使用者裝置親和性等待系統管理員核准。 媒體會在您核准核准之後，將使用者與目的地電腦產生關聯。 這項功能是以部署 OS 的工作順序範圍為基礎。 在此案例中，工作順序會在指定的使用者與目的地電腦之間建立關聯性。 然後，它會等候系統管理使用者核准，然後再部署 OS。

  • AutoApproval：允許自動核准使用者裝置親和性。 媒體會自動將使用者與目的地電腦產生關聯。 這項功能是以部署 OS 之工作順序的動作為基礎。 在此案例中，工作順序會在將 OS 部署至目的地電腦時，在指定的使用者和目的地電腦之間建立關聯性。

Type:UserDeviceAffinityType
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Variable

從此媒體指定工作順序部署期間要使用的工作順序變數雜湊表。

Type:Hashtable
Aliases:TaskSequenceVariables, Variables
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

指定此媒體版本的選擇性字串值，適用于追蹤和修訂用途。 最大長度為 32 個字元。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

System.Object

備註

Cmdlet 別名： New-CMPrestagedMedia