Share via

New-CMCaptureMedia

  • Referência
Módulo:
ConfigurationManager

Cria mídia de captura.

Syntax

New-CMCaptureMedia
   [-AllowUacPrompt]
   -BootImage <IResultObject>
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   [-SiteCode <String>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-TemporaryFolder <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Os cmdlets New-CMCaptureMedia criam mídia usada para capturar uma imagem de implantação do sistema operacional de um computador de referência.

OBSERVAÇÃO: este cmdlet requer permissões elevadas para ser executado.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Criar mídia de captura

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

O primeiro comando obtém o objeto de imagem de inicialização chamado Imagem de inicialização (x64) e armazena o objeto na variável $BootImage.

O segundo comando obtém o objeto de ponto de distribuição para o código do site chamado CM1 e armazena o objeto na variável $DistributionPoint.

O último comando cria mídia de captura usando o BootImage armazenado em $BootImage e o ponto de distribuição armazenado em $DistributionPoint.

Parâmetros

-AllowUacPrompt

Indica que os prompts do UAC (Controle de Conta de Usuário) são permitidos.

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

-BootImage

Especifica um objeto de imagem de inicialização. Para obter um objeto de imagem de inicialização, use o cmdlet Get-CMBootImage .

Type:IResultObject
Aliases:BootImagePackage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-DistributionPoint

Especifica uma matriz de objetos de ponto de distribuição. Para obter um objeto de ponto de distribuição, use o cmdlet Get-CMDistributionPoint .

Type:IResultObject[]
Aliases:DistributionPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-FormatMedia

Indica que o cmdlet formata a unidade USB removível (FAT32) e a torna inicializável.

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

-MediaType

Especifica o modo de mídia. Os valores válidos são:

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

-NoAutoRun

Use esse parâmetro para configurar a seguinte opção do assistente de mídia criar sequência de tarefas: Incluir o arquivo autorun.inf na mídia

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

-Path

Especifica o nome e o caminho em que os arquivos de saída são gravados.

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

-SiteCode

{{ Preencher Descrição do SiteCode }}

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

-TemporaryFolder

{{ Preencher descrição do TemporaryFolder }}

Type:String
Aliases:TemporaryDirectory, StagingArea
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

System.Object