New-CMTSStepApplyOperatingSystem

Artigo
08/17/2021

SYNOPSIS

Crie um passo de imagem de aplicação de OS, que pode adicionar a uma sequência de tarefas.

SYNTAX

New-CMTSStepApplyOperatingSystem [-ConfigFileName <String>] [-ConfigFilePackage <IResultObject>]
 [-Destination <DestinationType>] [-DestinationDisk <Int32>] [-DestinationDriveLetter <String>]
 [-LayeredDriver <OsdLayeredDriver>] [-DestinationPartition <Int32>] [-DestinationVariable <String>]
 [-ImagePackage <IResultObject>] [-ImagePackageIndex <Int32>] [-InstallPackage <IResultObject>]
 [-InstallPackageIndex <Int32>] [-RunFromNet <Boolean>] [-Condition <IResultObject[]>] [-ContinueOnError]
 [-Description <String>] [-Disable] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Este cmdlet cria um novo objeto de passo De Aplicação OS Image. 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 OS.

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 OS. Salva este objeto na variável $osImgPkg. O passo seguinte cria um objeto para o passo de Imagem Aplicar OS, utilizando o $osImgPkg 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.

$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | 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

-ConfigFileName

Especifique o nome do ficheiro de um ficheiro de resposta não acompanhado ou Sysprep para utilizar para uma instalação personalizada. Utilize este parâmetro com o parâmetro ConfigFilePackage.

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

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

-ConfigFilePackage

Especifique um objeto de embalagem que inclua o ficheiro de resposta não acompanhado ou Sysprep para usar para uma instalação personalizada. Para obter este objeto, utilize o cmdlet Get-CMPackage. Utilize este parâmetro com o parâmetro ConfigFileName.

Type: IResultObject
Parameter Sets: (All)
Aliases: AnswerFilePackage

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 este SISTEMA. 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 SO. O passo aplica o SO a partir 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: False
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: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Instalar embalar

Especifique um objeto de pacote de upgrade de SO. O passo aplica o SO a partir desta fonte original de instalação. Utilize o parâmetro InstallPackageIndex para definir a edição.

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

Type: IResultObject
Parameter Sets: (All)
Aliases: UpgradePackage

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

-InstalarPackageIndex

Especifique um valor inteiro da edição do pacote de upgrade do SO. Utilize este parâmetro com o parâmetro InstallPackage.

Type: Int32
Parameter Sets: (All)
Aliases: UpgradePackageIndex

Required: False
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

-RunFromNet

Desaponte este parâmetro $true para permitir que a sequência de tarefas aplique a imagem de SO diretamente a partir do ponto de distribuição.

Para maior segurança, recomenda-se não ativar esta definição. Esta opção destina-se a ser utilizada em dispositivos com capacidade de armazenamento limitada. Para obter mais informações, consulte o conteúdo do Access diretamente a partir do ponto de distribuição.

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

Required: False
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

-LayeredDriver

A partir da versão 2107, use este parâmetro para selecionar outros tipos de teclados que são comuns com línguas japonesas e coreanas. Especifique um valor inteiro para o controlador em camadas instalar com Windows. Utilize os mesmos valores que a variável de sequência de tarefas OsdLayeredDriver.

Type: OsdLayeredDriver
Parameter Sets: (All)
Aliases: KeyboardDriver

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_ApplyOperatingSystemAction

NOTAS

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

Get-CMTSStepAppApplyOperatingSystem Remove-CMTSStepAppApptingSystem Sistema operativo Set-CMTSStepAppappting

Sobre etapas de sequência de tarefas: Aplicar a imagem do OS