New-CMBootableMedia

  • 参考
模块:
ConfigurationManager

创建可启动媒体。

语法

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 需要提升的权限才能运行。

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

-AllowUnattended

添加此参数以允许无人参与的 OS 部署。 无人参与的 OS 部署不会提示输入网络配置或可选任务序列。

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 参数导入用于 HTTPS 通信的 PKI 证书，请使用此参数指定证书文件的密码。

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 的自动运行功能的详细信息，请参阅 创建已启用自动运行的 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