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>] Description
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第一個命令會取得名為開機映射的開機映射物件， (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 會將卸載式 USB 磁碟驅動器格式化 (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
{{ 填入 SiteCode 描述 }}
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TemporaryFolder
{{ 填滿 TemporaryFolder 描述 }}
| 類型: | String |
| 別名: | TemporaryDirectory, StagingArea |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
System.Object