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 @parametersExemplo 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 @parametersExemplo 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 @parametersExemplo 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 AllParâ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 |
-CaptureLocallyUsingLink
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:
$true: a sequência de tarefas configura a localização do estado local e captura localmente através de ligações em vez de ao copiar ficheiros. Este valor configura o passo Capturar Estado do Utilizador .- Utilize o parâmetro CaptureLocallyUsingLink para configurar a utilização de ligações fixas.
$false: a sequência de tarefas inclui passos para utilizar um ponto de migração de estado. Configura os seguintes passos:
| 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.