New-CMTSStepApplyDataImage

  • Referência
Módulo:
ConfigurationManager

Crie uma etapa Aplicar Imagem de Dados , que você pode adicionar a uma sequência de tarefas.

Syntax

New-CMTSStepApplyDataImage
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   -ImagePackage <IResultObject>
   -ImagePackageIndex <Int32>
   [-WipePartition <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria um novo objeto de etapa Aplicar Imagem de Dados . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, confira Sobre as etapas da sequência de tarefas: Aplicar Imagem de Dados.

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

Este exemplo usa primeiro o cmdlet Get-CMOperatingSystemImage para obter um objeto para o pacote de imagem de dados. Ele salva esse objeto na variável $pkgDataImg . A próxima etapa cria um objeto para a etapa Aplicar Imagem de Dados , usando o objeto $pkgDataImg como o pacote de imagem.

Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 11.

$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1

$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast

$ts | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Parâmetros

-Condition

Especifique um objeto de condição a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Adicione esse parâmetro para habilitar a opção de etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.

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

-Description

Especifique uma descrição opcional para esta etapa de sequência de tarefas.

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

-Destination

Especifique o local em que você deseja aplicar essa imagem de dados. Se você não especificar esse parâmetro, o padrão será NextAvailableFormattedPartition.

  • NextAvailableFormattedPartition: use a próxima partição sequencial ainda não direcionada por uma etapa Aplicar Sistema Operacional ou Aplicar Imagem de Dados nesta sequência de tarefas.

  • SpecificDiskAndPartition: especifique o número do disco com o parâmetro DestinationDisk e o número de partição com o parâmetro DestinationPartition .

  • SpecificLogicalDriverLetter: use o parâmetro DestinationDriveLetter para especificar a letra de unidade lógica atribuída à partição pelo Windows PE. Essa letra de unidade pode ser diferente da letra da unidade atribuída pelo sistema operacional recém-implantado.

  • LogicalDriverLetterInVariable: use o parâmetro DestinationVariable para especificar a variável de sequência de tarefas que contém a letra da unidade atribuída à partição pelo Windows PE. Essa variável normalmente é definida com o parâmetro DiskNumberVariable do set-CMTSStepPartitionDisk ou cmdlets New-CMTSStepPartitionDisk para a etapa sequência de tarefas Formatar e Partição disco .

Type:DestinationType
Accepted values:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationDisk

Ao usar -Destination SpecificDiskAndPartition, use esse parâmetro para especificar o número do disco. Especifique um inteiro de 0 para 99. Use também o parâmetro DestinationPartition .

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

-DestinationDriveLetter

Ao usar -Destination SpecificLogicalDriverLetter, use esse parâmetro para especificar a letra de unidade lógica. Especifique uma letra de unidade de C para Z.

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

-DestinationPartition

Ao usar -Destination SpecificDiskAndPartition, use esse parâmetro para especificar o número de partição. Especifique um inteiro de 1 para 99. Use também o parâmetro DestinationDisk .

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

-DestinationVariable

Ao usar -Destination LogicalDriverLetterInVariable, use esse parâmetro para especificar a variável de sequência de tarefas com a letra de unidade lógica. O nome da variável precisa ser alfanumérico sem espaços e menos de 256 caracteres.

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

-Disable

Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
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

-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

-ImagePackage

Especifique um objeto de pacote de imagem de dados. A etapa aplica os dados dessa imagem. Use o parâmetro ImagePackageIndex para definir o índice de imagem.

Para obter esse objeto, use o cmdlet Get-CMOperatingSystemImage .

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

-ImagePackageIndex

Especifique um valor inteiro do índice de imagem. Use esse parâmetro com o parâmetro ImagePackage .

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

-Name

Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WipePartition

Essa configuração é habilitada por padrão, que exclui todo o conteúdo na partição antes de aplicar a imagem.

Defina esse parâmetro para $false não excluir o conteúdo anterior da partição. Essa ação pode ser usada para aplicar mais conteúdo a uma partição de destino anterior.

Type:Boolean
Aliases:WipePartitionBeforeApplyImage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_ApplyDataImageAction classe WMI do servidor.