New-CMPrestageMedia

模块:

ConfigurationManager

创建 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>]

说明

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

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

类型:	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 参数导入用于 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

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

相关链接

• Get-CMApplication
• Get-CMBootImage
• Get-CMDistributionPoint
• Get-CMDriverPackage
• Get-CMManagementPoint
• Get-CMOperatingSystemImage
• Get-CMPackage
• 计划预留媒体