New-CMBootableMedia

  • 參考
模組:
ConfigurationManager

建立可開機媒體。

Syntax

New-CMBootableMedia
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

此 Cmdlet 會建立用來部署 OS 的媒體。 可開機媒體包含開機映射、選擇性啟動前置命令和相關聯的檔案，以及Configuration Manager檔案。 使用可開機媒體在新電腦上安裝新版本的 Windows (裸機) ，或取代現有的電腦和傳輸設定。

注意事項

此 Cmdlet 需要較高的許可權才能執行。

如需詳細資訊，請 參閱工作順序媒體概觀。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：建立可開機媒體

第一個命令會取得名為 開機映射 (x64) 的開機映射物件，並將它儲存在 $BootImage 變數中。 第二個命令會取得 SiteServer01.Contoso.com 的發佈點角色，並將它儲存在 $DistributionPoint 變數中。 第三個命令會取得 SiteServer02.Contoso.com 的管理點角色，並將它儲存在 $ManagementPoint 變數中。 最後一個命令會在動態模式中建立可開機媒體。 它會使用儲存在先前變數中的 物件。

$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"

New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint

參數

-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

-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

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-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

-FormatMedia

如果 MediaType 為 Usb ，您可以新增此參數，將抽取式 USB 磁片磁碟機格式化為 FAT32，並使其可開機。

Type:SwitchParameter
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

-MediaType

指定媒體是 CD/DVD 集或卸載式 USB 磁片磁碟機。

Type:MediaInputType
Accepted values:Usb, CdDvd
Position:Named
Default value:None
Required:True
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

-Path

如果MediaType為 CdDvd ，請指定Configuration Manager寫入輸出檔案的名稱和路徑。 例如，C:\output\boot.iso。

Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrestartCommand

指定在工作順序之前執行的啟動前置命令。 啟動前置命令是腳本或可執行檔，可在執行工作順序以安裝 OS 之前，在 Windows PE 中與使用者互動。 如果命令不是 Windows PE 的原生命令，請使用 PrestartPackage 來包含命令的檔案。

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

-PrestartPackage

如果您使用 PrestartCommand 參數，請使用此參數來指定包含啟動前置命令檔案的套件。 若要取得套件物件，請使用 Get-CMPackage Cmdlet。

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

-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

-WhatIf

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

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

輸入

None

輸出

System.Object