New-CMTSStepApplyOperatingSystem
Crie uma etapa Aplicar imagem do sistema operacional, que você 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 etapa Aplicar imagem do sistema operacional. 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, consulte Sobre etapas de sequência de tarefas: Aplicar a imagem do sistema operacional.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1
Este exemplo usa primeiro o cmdlet Get-CMOperatingSystemImage para obter um objeto para o pacote de imagem do sistema operacional. Ele salva esse objeto na variável $osImgPkg. A próxima etapa cria um objeto para a etapa Aplicar imagem do sistema operacional, usando o objeto $osImgPkg 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.
$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
Parâmetros
-Condition
Especifique um objeto condition a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets de condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFileName
Especifique o nome de arquivo de um arquivo de resposta sem supervisão ou Sysprep a ser usado para uma instalação personalizada. Use esse parâmetro com o parâmetro ConfigFilePackage.
Type: | String |
Aliases: | AnswerFileName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFilePackage
Especifique um objeto de pacote que inclua o arquivo de resposta autônoma ou Sysprep a ser usado para uma instalação personalizada. Para obter esse objeto, use o cmdlet Get-CMPackage. Use esse parâmetro com o parâmetro ConfigFileName.
Type: | IResultObject |
Aliases: | AnswerFilePackage |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Adicione esse parâmetro para habilitar a opção 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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Especifique o local onde você deseja aplicar esse sistema operacional. 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 de 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 por 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 por Windows PE. Normalmente, essa variável é definida com o parâmetro DiskNumberVariable dos cmdlets Set-CMTSStepPartitionDisk ou New-CMTSStepPartitionDisk para a etapa de sequência de tarefas Format and Partition Disk.
Type: | DestinationType |
Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDisk
Quando você usa -Destination SpecificDiskAndPartition
, use esse parâmetro para especificar o número do disco. Especifique um inteiro 0
de para 99
. Use também o parâmetro DestinationPartition.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDriveLetter
Quando você usa -Destination SpecificLogicalDriverLetter
, use esse parâmetro para especificar a letra da unidade lógica. Especifique uma letra de unidade C
de para Z
.
Type: | String |
Aliases: | DestinationLogicalDrive |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationPartition
Quando você usa -Destination SpecificDiskAndPartition
, use esse parâmetro para especificar o número de partição. Especifique um inteiro 1
de para 99
. Use também o parâmetro DestinationDisk.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationVariable
Quando você usa -Destination LogicalDriverLetterInVariable
, use esse parâmetro para especificar a variável de sequência de tarefas com a letra da 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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackage
Especifique um objeto de pacote de imagem do sistema operacional. A etapa aplica o sistema operacional a partir 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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackage
Especifique um objeto de pacote de atualização do sistema operacional. A etapa aplica o sistema operacional a partir dessa fonte de instalação original. Use o parâmetro InstallPackageIndex para definir a edição.
Para obter esse objeto, use o cmdlet Get-CMOperatingSystemInstaller.
Type: | IResultObject |
Aliases: | UpgradePackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackageIndex
Especifique um valor inteiro da edição do pacote de atualização do sistema operacional. Use esse parâmetro com o parâmetro InstallPackage.
Type: | Int32 |
Aliases: | UpgradePackageIndex |
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 comuns aos idiomas japonês e coreano. Especifique um valor inteiro para o driver em camadas instalar com Windows. Use os mesmos valores da variável de sequência de tarefas OsdLayeredDriver.
Type: | OsdLayeredDriver |
Aliases: | KeyboardDriver |
Accepted values: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFromNet
De definir esse parâmetro para permitir que a sequência de tarefas aplique a imagem $true
do sistema operacional diretamente do ponto de distribuição.
Para maior segurança, é recomendável não habilitar essa configuração. Essa opção foi projetada para uso em dispositivos com capacidade de armazenamento limitada. Para obter mais informações, consulte Acessar conteúdo diretamente do ponto de distribuição.
Type: | Boolean |
Aliases: | AllowAccessFromDistributionPoint |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_ApplyOperatingSystemAction classe WMI do servidor.