Set-CMTaskSequence
Define uma sequência de tarefas Configuration Manager.
Syntax
Set-CMTaskSequence
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-BootImageId <String>]
[-Category <String>]
[-CustomText <String>]
[-DeploymentPackageId <String>]
[-Description <String>]
[-DisableTaskSequence <Boolean>]
[-EnableNotification <Boolean>]
[-EnableTaskSequence <Boolean>]
[-HighPerformance <Boolean>]
-InputObject <IResultObject>
[-MaxRunTimeMins <Int64>]
[-NewName <String>]
[-PassThru]
[-ProgramName <String>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-RunAnotherProgram <Boolean>]
[-RunEveryTime <Boolean>]
[-RunOnAnyPlatform]
[-SuppressNotification <Boolean>]
[-UseBootImage <Boolean>]
[-UseDefaultText <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTaskSequence
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-BootImageId <String>]
[-Category <String>]
[-CustomText <String>]
[-DeploymentPackageId <String>]
[-Description <String>]
[-DisableTaskSequence <Boolean>]
[-EnableNotification <Boolean>]
[-EnableTaskSequence <Boolean>]
[-HighPerformance <Boolean>]
[-MaxRunTimeMins <Int64>]
[-NewName <String>]
[-PassThru]
[-ProgramName <String>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-RunAnotherProgram <Boolean>]
[-RunEveryTime <Boolean>]
[-RunOnAnyPlatform]
[-SuppressNotification <Boolean>]
-TaskSequenceId <String>
[-UseBootImage <Boolean>]
[-UseDefaultText <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTaskSequence
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-BootImageId <String>]
[-Category <String>]
[-CustomText <String>]
[-DeploymentPackageId <String>]
[-Description <String>]
[-DisableTaskSequence <Boolean>]
[-EnableNotification <Boolean>]
[-EnableTaskSequence <Boolean>]
[-HighPerformance <Boolean>]
[-MaxRunTimeMins <Int64>]
[-NewName <String>]
[-PassThru]
[-ProgramName <String>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-RunAnotherProgram <Boolean>]
[-RunEveryTime <Boolean>]
[-RunOnAnyPlatform]
[-SuppressNotification <Boolean>]
-TaskSequenceName <String>
[-UseBootImage <Boolean>]
[-UseDefaultText <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Set-CMTaskSequence modifica uma sequência de tarefas Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: Obter uma sequência de tarefas e alterar seu nome
PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"O primeiro comando obtém o objeto de sequência de tarefas chamado TaskSequence01 e armazena o objeto na variável $TaskSequence.
O segundo comando altera o nome da sequência de tarefas armazenada em $TaskSequence para NewTS01.
Exemplo 2: passar uma sequência de tarefas e alterar seu nome
PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"Esse comando obtém o objeto de sequência de tarefas chamado TaskSequence02 e usa o operador de pipeline para passar o objeto para Set-CMTaskSequence, que altera o nome do objeto da sequência de tarefas para NewTS02.
Parâmetros
-AddSupportedOperatingSystemPlatform
Adiciona um objeto de plataforma do sistema operacional com suporte à sequência de tarefas. Para obter um objeto de plataforma do sistema operacional com suporte, use o cmdlet Get-CMSupportedPlatform .
| Type: | IResultObject[] |
| Aliases: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageId
Especifica a ID de uma imagem de inicialização.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Category
Especifica uma categoria para a sequência de tarefas. Você pode usar categorias para agrupar sequências de tarefas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomText
Especifica texto personalizado para a sequência de tarefas. O texto personalizado é exibido na caixa de diálogo de notificação de progresso enquanto a sequência de tarefas é executada.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentPackageId
Especifica a ID de um pacote. Se você especificar um valor de $True para o parâmetro RunAnotherProgram , o pacote especificado será executado antes da execução da sequência de tarefas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica uma descrição para a sequência de tarefas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableTaskSequence
Indica se deve desabilitar essa sequência de tarefas.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableNotification
Indica se é necessário habilitar notificações para essa sequência de tarefas.
| Type: | Boolean |
| Aliases: | EnableNotifications |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableTaskSequence
Indica se deve habilitar essa sequência de tarefas.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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). Você não pode combiná-lo com DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HighPerformance
Use esse parâmetro para definir a seguinte opção na página Desempenho das propriedades da sequência de tarefas: Executar como plano de energia de alto desempenho.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifica um objeto de sequência de tarefas. Para obter um objeto de sequência de tarefas, use o cmdlet Get-CMTaskSequence .
| Type: | IResultObject |
| Aliases: | TaskSequence |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaxRunTimeMins
Especifica, em minutos, o tempo máximo de execução da sequência de tarefas.
| Type: | Int64 |
| Aliases: | Duration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifica um novo nome para a sequência de tarefas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retorna o objeto de trabalho atual. Por padrão, esse cmdlet não gera saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgramName
Especifica o nome de um programa a ser executado a partir de um pacote de software Configuration Manager especificado pelo parâmetro DeploymentPackageId.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveSupportedOperatingSystemPlatform
Remove um objeto de plataforma do sistema operacional com suporte da sequência de tarefas. Para obter um objeto de plataforma do sistema operacional com suporte, use o cmdlet Get-CMSupportedPlatform .
| Type: | IResultObject[] |
| Aliases: | RemoveSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAnotherProgram
Indica se deve executar outro programa antes de executar a sequência de tarefas. Especifique o programa usando o parâmetro DeploymentPackageId e o parâmetro ProgramName .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunEveryTime
Indica se o programa especificado no parâmetro ProgramName é executado sempre que a sequência de tarefas é executada. Se você especificar um valor de $False, o programa não será executado se ele tiver sido executado com êxito no passado.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunOnAnyPlatform
Indica que a sequência de tarefas é executada em qualquer plataforma do sistema operacional.
| Type: | SwitchParameter |
| Aliases: | ClearSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuppressNotification
Indica se deve suprimir as notificações para essa sequência de tarefas.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceId
Especifica a ID de uma sequência de tarefas.
| Type: | String |
| Aliases: | Id, TaskSequencePackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceName
Especifica o nome de uma sequência de tarefas.
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseBootImage
Indica se a sequência de tarefas usa a imagem de inicialização especificada usando o parâmetro BootImageID .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseDefaultText
Indica se o texto padrão deve ser usado na caixa de diálogo de notificação em andamento enquanto a sequência de tarefas é executada. Se você selecionar um valor de $False para este parâmetro, especifique o texto personalizado usando o parâmetro CustomText .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de