Compartilhar via


New-CMTaskSequence

Criar uma sequência de tarefas.

Sintaxe

New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-BuildOperatingSystemImage]
   [-ClientPackagePackageId <String>]
   [-CreatedBy <String>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-ImageDescription <String>]
   [-ImageVersion <String>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   [-MaximumServerConnection <Int32>]
   -Name <String>
   -OperatingSystemFileAccount <String>
   [-OperatingSystemFileAccountPassword <SecureString>]
   -OperatingSystemFilePath <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-CaptureLocallyUsingLink <Boolean>]
   [-CaptureNetworkSetting <Boolean>]
   [-CaptureUserSetting <Boolean>]
   [-CaptureWindowsSetting <Boolean>]
   [-ClientPackagePackageId <String>]
   [-ConfigureBitLocker <Boolean>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   [-InstallOperatingSystemImage]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   -Name <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-PartitionAndFormatTarget <Boolean>]
   [-ProductKey <String>]
   [-SaveLocally <Boolean>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-UserStateMigrationToolPackageId <String>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   -Name <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-UpgradeOperatingSystem]
   -UpgradePackageId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-BootImagePackageId <String>]
   [-CustomTaskSequence]
   [-Description <String>]
   [-HighPerformance <Boolean>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para criar uma sequência de tarefas. Normalmente, utiliza uma sequência de tarefas para implementar um SO num cliente, mas pode utilizá-lo para vários fins. Para obter mais informações, veja Gerir sequências de tarefas para automatizar tarefas.

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: Criar uma sequência de tarefas personalizada

Este exemplo introduz primeiro os parâmetros do cmdlet na variável parameters . Não é necessário alterar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comandos tão longa.

Este comando cria uma sequência de tarefas em branco com o nome Personalizado.

$parameters = @{
  CustomTaskSequence = $true
  Name = "Custom"
  Description = "NewCustom parameter set"
  HighPerformance = $false
  BootImagePackageId = "XYZ00002"
}

New-CMTaskSequence @parameters

Exemplo 2: Criar uma sequência de tarefas para instalar uma imagem do SO

Este exemplo introduz primeiro os parâmetros do cmdlet na variável parameters . Não é necessário alterar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comandos tão longa.

Este comando cria uma sequência de tarefas denominada Instalar imagem do SO que instala uma imagem do SO. Também inclui os outros parâmetros que se aplicam a este cenário.

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  InstallOperatingSystemImage = $true
  Name = "Install OS image"
  Description = "NewInstallOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  CaptureNetworkSetting = $true
  CaptureUserSetting = $true
  SaveLocally = $true
  CaptureLocallyUsingLink = $true
  UserStateMigrationToolPackageId = "XYZ00001"
  CaptureWindowsSetting = $true
  ConfigureBitLocker = $true
  PartitionAndFormatTarget = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "DomainType"
  DomainAccount = "contoso\jqpublic"
  DomainName = "contoso"
  DomainOrganizationUnit = "LDAP://OU=Workstations,OU=Devices,DC=na,DC=contoso,DC=com"
  DomainPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $false
  SoftwareUpdateStyle = "All"
}

New-CMTaskSequence @parameters

Exemplo 3: Criar uma sequência de tarefas para criar e capturar um SO

Este exemplo introduz primeiro os parâmetros do cmdlet na variável parameters . Não é necessário alterar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comandos tão longa.

Este exemplo cria uma sequência de tarefas denominada Compilar e capturar que compila e captura uma imagem do SO com a localização e a conta fornecidas. Também inclui os outros parâmetros que se aplicam a este cenário.

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  BuildOperatingSystemImage = $true
  Name = "Build and capture"
  Description = "NewBuildOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "WorkgroupType"
  WorkgroupName = "groupwork"
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $true
  SoftwareUpdateStyle = "All"
  OperatingSystemFilePath = "\\server1\images\capture.wim"
  ImageDescription = "image description"
  ImageVersion = "image version 1"
  CreatedBy = "jqpublic"
  OperatingSystemFileAccount = "contoso\jqpublic" 
  OperatingSystemFileAccountPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
}

New-CMTaskSequence @parameters

Exemplo 4: Criar uma sequência de tarefas para atualizar um SO

Este comando cria a sequência de tarefas denominada Atualização no local e especifica que irá atualizar o SO com o pacote de atualização com o ID XYZ02EBA.

New-CMTaskSequence -UpgradeOperatingSystem -Name "In-place upgrade" -UpgradePackageId "XYZ02EBA" -SoftwareUpdateStyle All

Parâmetros

-ApplicationName

Especifique uma matriz de nomes de aplicações a instalar durante a sequência de tarefas. Este parâmetro configura o passo de sequência de tarefas Instalar Aplicação .

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplyAll

No cenário de compilação e captura, o estado deste parâmetro determina os seguintes comportamentos:

  • $true: a sequência de tarefas não formata & partição do disco antes de aplicar a imagem do SO.

  • $false: a sequência de tarefas inclui os passos Formatar e Particionar Disco antes de aplicar a imagem do SO.

Tipo:Boolean
Aliases:ApplyAllImages
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BootImagePackageId

Especifique o ID de um pacote de imagem de arranque a utilizar com uma sequência de tarefas que implementa um SO. Este valor é um ID de pacote padrão, por exemplo XYZ00005.

Este parâmetro configura as propriedades da sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BuildOperatingSystemImage

Adicione este parâmetro para criar uma sequência de tarefas para o cenário de compilação e captura. Para obter mais informações, veja Criar uma sequência de tarefas para capturar um SO.

Tipo:SwitchParameter
Aliases:BuildOperatingSystemImageOption
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Quando ativar o parâmetro SaveLocally para guardar as definições e os ficheiros do utilizador localmente, defina este parâmetro para $true capturar localmente através de ligações em vez de copiar ficheiros. As ligações que o Configuration Manager utiliza para armazenar o estado do utilizador localmente são referidas como ligações fixas.

O cmdlet ignora este parâmetro se SaveLocally for $false.

Este parâmetro configura o passo Capturar Estado do Utilizador .

Tipo:Boolean
Aliases:CaptureLocallyUsingLinks
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CaptureNetworkSetting

Defina este parâmetro como $true para ativar a sequência de tarefas para capturar as definições de rede. Quando ativa esta opção, a sequência de tarefas inclui o passo Capturar Definições de Rede .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CaptureUserSetting

Defina este parâmetro como $true para ativar a sequência de tarefas para capturar as definições e os ficheiros do utilizador. Quando ativa esta opção, a sequência de tarefas inclui o passo Capturar Estado do Utilizador . Utilize também o parâmetro UserStateMigrationToolPackageId .

Utilize SaveLocally e CaptureLocallyUsingLink para configurar onde a sequência de tarefas guarda o estado do utilizador.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CaptureWindowsSetting

Defina este parâmetro como $true para ativar a sequência de tarefas para capturar as definições do Windows. Quando ativa esta opção, a sequência de tarefas inclui o passo Capturar Definições do Windows .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClientPackagePackageId

Especifique o ID do pacote de cliente a instalar quando a sequência de tarefas for executada. Este valor é um ID de pacote padrão, por exemplo, XYZ00003. A atribuição de sites e a configuração do cliente ocorrem automaticamente. Pode especificar parâmetros de instalação adicionais com o parâmetro InstallationProperty .

Este parâmetro configura o passo de sequência de tarefas Configurar o Windows e o ConfigMgr .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConfigureBitLocker

Defina este parâmetro como $true para configurar a sequência de tarefas para utilização com o BitLocker. Quando ativa esta opção, a sequência de tarefas inclui os seguintes passos:

Tipo:Boolean
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CreatedBy

Para o cenário de compilação e captura, especifique uma cadeia opcional que esteja no ficheiro de imagem capturado para quem o criou. O tamanho máximo é de 255 caracteres.

Este parâmetro configura o passo de sequência de tarefas Capturar Imagem do SO .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomTaskSequence

Adicione este parâmetro para criar uma sequência de tarefas personalizada que não contém passos. Para obter mais informações, veja Criar uma sequência de tarefas personalizada.

Em seguida, pode utilizar os 35 cmdlets New-CMTSStep para adicionar passos à sequência de tarefas personalizada. Para obter mais informações, veja Acerca dos passos de sequência de tarefas. Cada secção descreve os passos de sequência de tarefas, com ligações para os cmdlets associados.

Tipo:SwitchParameter
Aliases:CustomOption
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para a sequência de tarefas. O comprimento máximo é de 512 carateres. Este parâmetro configura as propriedades da sequência de tarefas.

Tipo:String
Aliases:TaskSequenceDescription
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

-DomainAccount

Especifique uma conta que tenha as permissões necessárias para associar o computador ao domínio. Utilize o seguinte formato: Domain\User. Para obter mais informações, veja ask sequence domain join account (Pedir conta de associação a um domínio de sequência).

Utilize o parâmetro DomainName para especificar o nome de domínio e DomainPassword para especificar a palavra-passe desta conta.

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições de Rede .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainName

Especifique o nome de um domínio para associar o computador quando executar a sequência de tarefas. Este parâmetro configura o passo de sequência de tarefas Aplicar Definições de Rede .

Utilize o parâmetro DomainAccount para especificar uma conta que tenha permissões para aderir a este domínio. Também pode utilizar o parâmetro DomainOrganizationUnit para especificar uma UO na qual criar a conta de computador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainOrganizationUnit

Especifique uma unidade organizacional (UO) de domínio na qual criar a conta de computador no domínio. O formato deste valor é o caminho LDAP (Lightweight Directory Access Protocol), por exemplo: LDAP//OU=OSD staging,DC=contoso,DC=com. Especifique uma UO no domínio que especificou no parâmetro DomainName .

Se uma conta de computador existente já estiver numa UO, o Active Directory não lhe permite alterar a UO e ignora esta definição.

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições de Rede .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainPassword

Especifique uma cadeia segura para a palavra-passe da conta que especificou com o parâmetro DomainAccount .

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições de Rede .

Tipo:SecureString
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

-GeneratePassword

Defina este parâmetro como $true para gerar aleatoriamente a palavra-passe de administrador local e desativar a conta. Esta configuração é recomendada.

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições do Windows .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HighPerformance

Defina este parâmetro como $true para permitir que a opção de sequência de tarefas seja executada como um esquema de energia de alto desempenho. Este parâmetro configura as propriedades da sequência de tarefas. Para obter mais informações, veja Melhorias de desempenho para esquemas de energia.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IgnoreInvalidApplication

Se definir este parâmetro como $true, a sequência de tarefas continuará a instalar aplicações na lista se uma instalação da aplicação falhar. Utilize este parâmetro com o parâmetro ApplicationName .

Este parâmetro configura o passo de sequência de tarefas Instalar Aplicação .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImageDescription

Para o cenário de compilação e captura, especifique uma cadeia opcional que descreva o ficheiro de imagem capturado. O tamanho máximo é de 255 caracteres.

Este parâmetro configura o passo de sequência de tarefas Capturar Imagem do SO .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImageVersion

Para o cenário de compilação e captura, especifique uma cadeia opcional como a versão do ficheiro de imagem capturado. Se definir este valor, não tem de ser a versão do SO. O comprimento máximo é de 32 carateres.

Este parâmetro configura o passo de sequência de tarefas Capturar Imagem do SO .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstallationLicensingMode

Esta definição aplica-se apenas a versões legadas do Windows que já não são suportadas. A partir da versão 2010, a definição já não é visível no editor de sequência de tarefas. As sequências de tarefas existentes que ainda utilizam esta definição continuarão a funcionar da mesma forma.

Tipo:ServerLicensingMode
Valores aceitos:NonSpecify, PerSeat, PerServer
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstallationProperty

Especifique quaisquer propriedades de instalação adicionais a utilizar quando a sequência de tarefas instalar o cliente do Configuration Manager. A atribuição de sites e a configuração predefinida são especificadas automaticamente pela sequência de tarefas. Para introduzir várias propriedades de instalação, separe-as com um espaço. Se uma propriedade contiver espaços, coloque-a entre aspas ("). Para obter mais informações, veja Acerca dos parâmetros e propriedades de instalação do cliente no Configuration Manager.

Esta lista não pode incluir SMSSITECODE.

Este parâmetro configura o passo de sequência de tarefas Configurar o Windows e o ConfigMgr .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstallOperatingSystemImage

Adicione este parâmetro para criar uma sequência de tarefas para o cenário de instalação da imagem do SO. Para obter mais informações, veja Criar uma sequência de tarefas para instalar um SO.

Tipo:SwitchParameter
Aliases:InstallOperatingSystemImageOption
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JoinDomain

Utilize este parâmetro para configurar o passo de sequência de tarefas Aplicar Definições de Rede . O computador tem de aderir a um grupo de trabalho ou a um domínio.

  • DomainType: adira a um domínio. Especifique também DomainName, DomainAccount e DomainPassword. Também pode utilizar DomainOrganizationUnit.

  • WorkgroupType: adira a um grupo de trabalho. Especifique também WorkgroupName. Utilize este valor com o parâmetro BuildOperatingSystemImage . No cenário de compilação e captura, a sequência de tarefas associa sempre um grupo de trabalho antes de capturar a imagem.

Tipo:JoinType
Valores aceitos:DomainType, WorkgroupType
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LocalAdminPassword

Se não utilizar a opção recomendada para GeneratePassword, utilize este parâmetro para especificar uma cadeia segura como a palavra-passe de Administrador local.

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições do Windows .

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaximumServerConnection

Esta definição aplica-se apenas a versões legadas do Windows que já não são suportadas. A partir da versão 2010, a definição já não é visível no editor de sequência de tarefas. As sequências de tarefas existentes que ainda utilizam esta definição continuarão a funcionar da mesma forma.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para a sequência de tarefas. O comprimento máximo é de 50 carateres. Este parâmetro configura as propriedades da sequência de tarefas.

Tipo:String
Aliases:TaskSequenceName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemFileAccount

Para o cenário de compilação e captura, especifique o nome de uma conta de domínio que tenha permissões para a partilha de rede que especificar no parâmetro OperatingSystemFilePath . Utilize OperatingSystemFileAccountPassword para definir a palavra-passe da conta.

Este parâmetro configura o passo de sequência de tarefas Capturar Imagem do SO .

Tipo:String
Aliases:CaptureOperatingSystemFileAccount
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemFileAccountPassword

Para o cenário de criação e captura, especifique uma cadeia segura para a palavra-passe de OperatingSystemFileAccount.

Este parâmetro configura o passo de sequência de tarefas Capturar Imagem do SO .

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemFilePath

Para o cenário de compilação e captura, especifique o caminho do ficheiro para a localização de rede que o Configuration Manager utiliza para armazenar a imagem do SO capturada. O caminho inclui o nome do ficheiro com uma .wim extensão de ficheiro. Utilize OperatingSystemFileAccount e OperatingSystemFileAccountPassword para especificar uma conta que tenha acesso a esta localização.

Este parâmetro configura o passo de sequência de tarefas Capturar Imagem do SO .

Tipo:String
Aliases:CaptureOperatingSystemFilePath
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemImageIndex

Especifique o índice da imagem do SO a instalar para o passo de sequência de tarefas Aplicar Imagem do SO .

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemImagePackageId

Especifique o ID do pacote de imagem do SO a instalar. Utilize OperatingSystemImageIndex para especificar o índice de imagens. Este valor é um ID de pacote padrão, por exemplo XYZ00050.

Este parâmetro configura o passo de sequência de tarefas Aplicar Imagem do SO .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionAndFormatTarget

Defina este parâmetro como $true para a sequência de tarefas para particionar e formatar o computador de destino antes de instalar o SO.

Este parâmetro configura o passo de sequência de tarefas Formatar e Particionar Disco .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProductKey

Especifique a chave de produto do Windows para a instalação do SO.

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições do Windows .

Tipo:String
Aliases:InstallationProductKey
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SaveLocally

Se ativar o parâmetro CaptureUserSetting , utilize este parâmetro para determinar onde a sequência de tarefas guarda o estado do utilizador capturado:

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareUpdateStyle

Especifique se pretende instalar atualizações de software durante a sequência de tarefas. Os valores determinam o tipo de implementação de atualização de software:

  • All: disponível para instalação, todas as atualizações de software
  • Mandatory: necessário para instalação, apenas atualizações de software obrigatórias
  • NoInstall: Não instale quaisquer atualizações de software

Este parâmetro configura o passo de sequência de tarefas Instalar Atualizações de Software .

Tipo:SoftwareUpdateStyleType
Valores aceitos:All, Mandatory, NoInstall
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeZone

Especifique o fuso horário predefinido para esta instalação do Windows. Para obter um objeto de fuso horário, utilize o cmdlet Get-TimeZone incorporado.

Este parâmetro configura o passo de sequência de tarefas Aplicar Definições do Windows .

Tipo:TimeZoneInfo
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpgradeOperatingSystem

Adicione este parâmetro para criar uma sequência de tarefas para o cenário de atualização do SO. Para obter mais informações, veja Criar uma sequência de tarefas para atualizar um SO.

Tipo:SwitchParameter
Aliases:UpgradeOperatingSystemOption
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpgradePackageId

Especifique o ID do pacote de atualização do SO a utilizar. Este valor é um ID de pacote padrão, por exemplo XYZ00052.

Este parâmetro configura o passo de sequência de tarefas Atualizar SO.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserStateMigrationToolPackageId

Quando definir CaptureUserSetting como $true, utilize este parâmetro para especificar o ID do pacote da Ferramenta de Migração de Estado do Utilizador (USMT). Este valor é um ID de pacote padrão, por exemplo XYZ00012.

Este parâmetro configura os passos Capturar Estado do Utilizador e Restaurar Estado do Utilizador .

Tipo:String
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WorkgroupName

Se definir o parâmetro JoinDomain como WorkgroupType, utilize este parâmetro para especificar o nome do grupo de trabalho. Este parâmetro configura o passo de sequência de tarefas Aplicar Definições de Rede .

Tipo:String
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_TaskSequencePackage classe WMI de servidor.

No passo de sequência de tarefas Aplicar Definições do Windows , este cmdlet define o valor Nome de utilizador para o utilizador que executa o cmdlet e o Nome da organização para o nome do computador onde o cmdlet é executado.

Não pode configurar todas as definições de sequência de tarefas e passos com este cmdlet. Para configurar outras definições, utilize Set-CMTaskSequence e os cmdlets Set-CMTSStep , por exemplo , Set-CMTSStepApplyOperatingSystem.