New-CMBootableMedia
创建可启动媒体。
语法
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>] 说明
此 cmdlet 创建用于部署 OS 的媒体。 可启动媒体包含启动映像、可选的预启动命令和关联的文件以及 Configuration Manager 文件。 使用可启动媒体在新计算机上安装新版本的 Windows (裸机) ，或替换现有计算机并传输设置。
注意
此 cmdlet 需要提升的权限才能运行。
有关详细信息，请参阅 任务序列媒体概述。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建可启动媒体
第一个命令获取名为 Boot image (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 需要提升的权限才能运行。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowUnattended
添加此参数以允许无人参与的 OS 部署。 无人参与的 OS 部署不会提示输入网络配置或可选任务序列。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowUnknownMachine
添加此参数以允许 Configuration Manager 预配未知计算机。 未知计算机是站点尚未发现的计算机。
| 类型: | SwitchParameter |
| 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 参数导入用于 HTTPS 通信的 PKI 证书，请使用此参数指定证书文件的密码。
| 类型: | 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 |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DistributionPoint
指定将启动映像分发到的一个或多个分发点对象。 若要获取此对象，请使用 Get-CMDistributionPoint cmdlet。
| 类型: | IResultObject[] |
| 别名: | DistributionPoints |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Force
运行命令而不要求确认。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-FormatMedia
如果 MediaType 为 Usb，则可以添加此参数以将可移动 USB 驱动器格式化为 FAT32，并使其可启动。
| 类型: | SwitchParameter |
| 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 |
-MediaType
指定媒体是 CD/DVD 集还是可移动 USB 驱动器。
| 类型: | MediaInputType |
| 接受的值: | Usb, CdDvd |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NoAutoRun
添加此参数以在媒体上包括 autorun.inf 文件。 默认情况下，Configuration Manager 不会添加它。 反恶意软件产品通常阻止此文件。 有关 Windows 自动运行功能的详细信息，请参阅 创建已启用自动运行的 CD-ROM 应用程序。 如果方案仍有必要，请添加此参数以包含 文件。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Path
如果 MediaType 为 CdDvd，请指定 Configuration Manager 写入输出文件的名称和路径。 例如，C:\output\boot.iso。
| 类型: | String |
| 别名: | MediaPath, OutputPath, DriveName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrestartCommand
指定在任务序列之前运行的预启动命令。 预启动命令是在任务序列运行以安装 OS 之前与 Windows PE 中的用户进行交互的脚本或可执行文件。 如果命令不是 Windows PE 的本机命令，请使用 PrestartPackage 包含命令的文件。
| 类型: | String |
| 别名: | PreExecCommandLine |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrestartPackage
如果使用 PrestartCommand 参数，请使用此参数指定包含预启动命令的文件的包。 若要获取包对象，请使用 Get-CMPackage cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SiteCode
适用于版本 2010 及更高版本。 将此参数与 ManagementPoint 参数一起使用可指定网站代码。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | 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 |
-WhatIf
显示在 cmdlet 运行时发生的情况。 该 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
System.Object