New-CMCaptureMedia
创建捕获媒体。
语法
New-CMCaptureMedia
[-AllowUacPrompt]
-BootImage <IResultObject>
-DistributionPoint <IResultObject[]>
[-Force]
[-FormatMedia]
[-SiteCode <String>]
-MediaType <MediaInputType>
[-NoAutoRun]
-Path <String>
[-TemporaryFolder <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-CMCaptureMedia cmdlet 创建用于从引用计算机捕获操作系统部署映像的媒体。
注意:此 cmdlet 需要提升的权限才能运行。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:创建捕获媒体
PS XYZ:\> $BootImage = Get-CMBootImage -Name "Boot image (x64)"
PS XYZ:\> $DistributionPoint = Get-CMDistributionpoint -SiteCode CM1
PS XYZ:\> New-CMCaptureMedia -MediaType CdDvd -Path "\\server\share\CaptureMedia.iso" -BootImage $BootImage -DistributionPoint $DistributionPoint
第一个命令获取名为 Boot image (x64) 的启动映像对象,并将对象存储在 $BootImage 变量中。
第二个命令获取名为 CM1 的站点代码的分发点对象,并将对象存储在 $DistributionPoint 变量中。
最后一个命令使用存储在 $BootImage 中的 BootImage 和存储在 $DistributionPoint 中的分发点创建捕获媒体。
参数
-AllowUacPrompt
指示允许用户帐户控制 (UAC) 提示。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-BootImage
指定启动映像对象。 若要获取启动映像对象,请使用 Get-CMBootImage cmdlet。
类型: | IResultObject |
别名: | BootImagePackage |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | 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
指示 cmdlet 格式化可移动 U 盘 (FAT32) ,并使其可启动。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MediaType
指定媒体模式。 有效值包含:
- Usb
- CdDvd
- 硬盘
类型: | MediaInputType |
接受的值: | Usb, CdDvd |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-NoAutoRun
使用此参数在创建任务序列媒体向导中配置以下选项: 在媒体上包括 autorun.inf 文件
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Path
指定写入输出文件的名称和路径。
类型: | String |
别名: | MediaPath, OutputPath, DriveName |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-SiteCode
{{ Fill SiteCode Description }}
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TemporaryFolder
{{ Fill TemporaryFolder Description }}
类型: | String |
别名: | TemporaryDirectory, StagingArea |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
System.Object