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) 提示。

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

-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

指示 cmdlet 格式化可移动 U 盘 (FAT32) ,并使其可启动。

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

-MediaType

指定媒体模式。 有效值包含:

  • Usb
  • CdDvd
  • 高清
Type:MediaInputType
Accepted values:Usb, CdDvd
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoAutoRun

使用此参数在创建任务序列媒体向导中配置以下选项: 在媒体上包括 autorun.inf 文件

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

-Path

指定写入输出文件的名称和路径。

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

-SiteCode

{{ Fill SiteCode Description }}

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

-TemporaryFolder

{{ Fill TemporaryFolder Description }}

Type:String
Aliases:TemporaryDirectory, StagingArea
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