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 11Parâ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.