New-CMTSStepApplyOperatingSystem
Crie um passo Aplicar Imagem do SO , que pode adicionar a uma sequência de tarefas.
Sintaxe
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 Aplicar Imagem do SO . 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 Acerca dos passos de sequência de tarefas: Aplicar Imagem do SO.
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 do SO. Guarda este objeto na variável $osImgPkg . O passo seguinte cria um objeto para o passo Aplicar Imagem do SO , utilizando o objeto $osImgPkg 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.
$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 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 |
-ConfigFileName
Especifique o nome de ficheiro de um ficheiro de resposta automática ou Sysprep a utilizar para uma instalação personalizada. Utilize este parâmetro com o parâmetro ConfigFilePackage .
| Tipo: | String |
| Aliases: | AnswerFileName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConfigFilePackage
Especifique um objeto de pacote que inclua o ficheiro de resposta automática ou Sysprep a utilizar para uma instalação personalizada. Para obter este objeto, utilize o cmdlet Get-CMPackage . Utilize este parâmetro com o parâmetro ConfigFileName .
| Tipo: | IResultObject |
| Aliases: | AnswerFilePackage |
| 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 este SO. 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 do SO. O passo aplica o SO a partir 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: | False |
| 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: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InstallPackage
Especifique um objeto de pacote de atualização do SO. O passo aplica o SO desta origem de instalação original. Utilize o parâmetro InstallPackageIndex para definir a edição.
Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemInstaller .
| Tipo: | IResultObject |
| Aliases: | UpgradePackage |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InstallPackageIndex
Especifique um valor inteiro da edição do pacote de atualização do SO. Utilize este parâmetro com o parâmetro InstallPackage .
| Tipo: | Int32 |
| Aliases: | UpgradePackageIndex |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LayeredDriver
A partir da versão 2107, utilize este parâmetro para selecionar outros tipos de teclado comuns aos idiomas japonês e coreano. Especifique um valor inteiro para o controlador em camadas instalar com o Windows. Utilize os mesmos valores que a variável de sequência de tarefas OsdLayeredDriver .
| Tipo: | OsdLayeredDriver |
| Aliases: | KeyboardDriver |
| Valores aceitos: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| 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 |
-RunFromNet
Defina este parâmetro como para $true permitir que a sequência de tarefas aplique a imagem do SO diretamente a partir do ponto de distribuição.
Para maior segurança, recomenda-se que não ative esta definição. Esta opção foi concebida para utilização em dispositivos com capacidade de armazenamento limitada. Para obter mais informações, veja Aceder a conteúdos diretamente a partir do ponto de distribuição.
| Tipo: | Boolean |
| Aliases: | AllowAccessFromDistributionPoint |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| 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 |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_ApplyOperatingSystemAction classe WMI de servidor.