Partilhar via


New-CMTSStepApplyDataImage

SYNOPSIS

Crie um passo de Imagem de Dados, que 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 passo de 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, consulte sobre os passos da sequência de tarefas: Aplicar a Imagem de Dados.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1

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

Em seguida, obtém um objeto de sequência de tarefa, e adiciona este novo passo à sequência de tarefa 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

PARAMETERS

-Condição

Especifique um objeto de condição para usar com este passo. Para obter este objeto, utilize um dos cmdlets da sequência de tarefa. Por exemplo, Get-CMTSStepConditionVariable.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: Conditions

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-ContinueOnError

Adicione este parâmetro para ativar a opção de passo Continue a cometer erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continua.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Destino

Especifique o local onde pretende aplicar esta imagem de dados. Se não especificar este parâmetro, o padrão é NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: Utilize a próxima partição sequencial que ainda não é direcionada para um Sistema Operativo de Aplicação ou aplique o passo de Imagem de Dados nesta sequência de tarefa.

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

  • SpecificLogicalDriverLetter: Utilize o parâmetro DestinationDriveLetter para especificar a letra de acionamento lógico atribuída à partição por Windows PE. Esta carta de unidade pode ser diferente da letra de unidade atribuída pelo sor recém-implantado.

  • LogicalDriverLetterInVariable: Utilize o parâmetro DestinationVariable para especificar a variável da sequência de tarefas que contém a letra de unidade atribuída à partição por Windows PE. Esta variável é tipicamente definida com o parâmetro DiskNumberVariable do Set-CMTSStepPartitionDisk ou new-CMTSStepPartitionDisk cmdlets para o passo de sequência de função formato e disco de partição.

Type: DestinationType
Parameter Sets: (All)
Aliases:
Accepted values: NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable

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

-DestinationDisk

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

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationDriveLetter

Quando -Destination SpecificLogicalDriverLetter utilizar, utilize este parâmetro para especificar a letra de acionamento lógico. Especifique uma letra de unidade de C Z .

Type: String
Parameter Sets: (All)
Aliases: DestinationLogicalDrive

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

- DestinationPartition

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

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

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

Type: String
Parameter Sets: (All)
Aliases: DestinationVariableName

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

-Desativar

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableThisStep

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Pacote de imagens

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 imagem.

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

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-ImagePackageIndex

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

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

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

Type: String
Parameter Sets: (All)
Aliases: StepName

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-WipePartition

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

Desaje este parâmetro $false para não eliminar o conteúdo prévio da partição. Esta ação pode ser utilizada para aplicar mais conteúdo a uma divisória previamente direcionada.

Type: Boolean
Parameter Sets: (All)
Aliases: WipePartitionBeforeApplyImage

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyDataImageAction

NOTAS

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

Get-CMTSStepApplyDataImage Remover-CMTSStepApplyDataImage Set-CMTSStepApplyDataImage

Sobre etapas de sequência de tarefas: Aplicar imagem de dados