Compartilhar via


New-CMTSStepApplyDataImage

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

Sintaxe

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 passo Aplicar Imagem de Dados . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja Sobre os passos da sequência de tarefas: Aplicar Imagem de Dados.

Observação

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

Exemplos

Exemplo 1

Este exemplo utiliza primeiro o cmdlet Get-CMOperatingSystemImage para obter um objeto para o pacote de imagem de dados. Guarda este objeto na variável $pkgDataImg . O passo seguinte cria um objeto para o passo Aplicar Imagem de Dados , utilizando o objeto $pkgDataImg como o pacote de imagem.

Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à 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 utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Aliases:Conditions
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContinueOnError

Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para este passo de sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Destination

Especifique a localização onde pretende aplicar esta imagem de dados. Se não especificar este parâmetro, a predefinição é NextAvailableFormattedPartition.

  • NextAvailableFormattedPartition: utilize a partição sequencial seguinte ainda não visada por um passo Aplicar Sistema Operativo 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 da partição com o parâmetro DestinationPartition .

  • SpecificLogicalDriverLetter: utilize o parâmetro DestinationDriveLetter para especificar a letra de unidade lógica atribuída à partição pelo Windows PE. Esta letra de unidade pode ser diferente da letra de unidade atribuída pelo SO recentemente implementado.

  • LogicalDriverLetterInVariable: utilize o parâmetro DestinationVariable para especificar a variável de sequência de tarefas que contém a letra de unidade atribuída à partição pelo Windows PE. Normalmente, esta variável é definida com o parâmetro DiskNumberVariable dos cmdlets Set-CMTSStepPartitionDisk ou New-CMTSStepPartitionDisk para o passo de sequência de tarefas Formato e Disco de Partição .

Tipo:DestinationType
Valores aceitos:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DestinationDisk

Quando utilizar -Destination SpecificDiskAndPartition, utilize este parâmetro para especificar o número do disco. Especifique um número inteiro de 0 para 99. Utilize também o parâmetro DestinationPartition .

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DestinationDriveLetter

Quando utilizar , utilize -Destination SpecificLogicalDriverLettereste parâmetro para especificar a letra de unidade lógica. Especifique uma letra de unidade de C para Z.

Tipo:String
Aliases:DestinationLogicalDrive
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DestinationPartition

Quando utilizar -Destination SpecificDiskAndPartition, utilize este parâmetro para especificar o número da partição. Especifique um número inteiro de 1 para 99. Utilize também o parâmetro DestinationDisk .

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DestinationVariable

Quando utilizar , utilize -Destination LogicalDriverLetterInVariableeste parâmetro para especificar a variável de sequência de tarefas com a letra de unidade lógica. O nome da variável tem de ser alfanumérico sem espaços e com menos de 256 carateres.

Tipo:String
Aliases:DestinationVariableName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Disable

Adicione este parâmetro para desativar este passo de sequência de tarefas.

Tipo:SwitchParameter
Aliases:DisableThisStep
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImagePackage

Especifique um objeto de pacote de imagem de dados. O passo aplica os dados desta imagem. Utilize o parâmetro ImagePackageIndex para definir o índice de imagens.

Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemImage .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImagePackageIndex

Especifique um valor inteiro do índice de imagens. Utilize este parâmetro com o parâmetro ImagePackage .

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para este passo para identificá-lo na sequência de tarefas.

Tipo:String
Aliases:StepName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WipePartition

Esta definição está ativada por predefinição, o que elimina todo o conteúdo na partição antes de aplicar a imagem.

Defina este parâmetro para $false não eliminar os conteúdos anteriores da partição. Esta ação pode ser utilizada para aplicar mais conteúdo a uma partição anteriormente direcionada.

Tipo:Boolean
Aliases:WipePartitionBeforeApplyImage
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_ApplyDataImageAction classe WMI de servidor.