Add-CMTaskSequenceDeploymentType

Crie uma sequência de tarefas como um tipo de implantação de modelo de aplicativo.

Syntax

Add-CMTaskSequenceDeploymentType
   -ApplicationName <String>
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -ApplicationId <Int32>
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMTaskSequenceDeploymentType
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Aplica-se à versão 2006 e posterior. Crie uma sequência de tarefas como um tipo de implantação de modelo de aplicativo. Para obter mais informações, consulte Tipo de implantação de sequência de tarefas.

Este cmdlet tem uma sintaxe semelhante à do cmdlet add-CMMsiDeploymentTypedo tipo de implantação MSI. As principais diferenças são os seguintes parâmetros:

  • -InstallTaskSequenceId <string> (obrigatório): a ID da sequência de tarefas para instalar o aplicativo

  • -UninstallTaskSequenceId <string> (opcional): a ID da sequência de tarefas para desinstalar o aplicativo

Esses dois parâmetros se relacionam às opções de sequência de tarefas do tipo de implantação. Eles substituem -InstallCommand os -UninstallCommand parâmetros e no cmdlet MSI.

Exemplos

Exemplo 1: Adicionar um tipo de implantação de sequência de tarefas

Este exemplo adiciona a ID da sequência de tarefas ABC001EB ao aplicativo CBI. Ele também adiciona a ID da sequência de tarefas ABC00378desinstalação.

Add-CMTaskSequenceDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -Comment "New Deployment Type" -InstallTaskSequenceId "ABC001EB" -UninstallTaskSequenceId "ABC00378" -ScriptLanguage "PowerShell" -ScriptText "dir"

Parâmetros

-AddDetectionClause

Especifique uma matriz de cláusulas de método de detecção para esse tipo de implantação. Para criar uma cláusula de detecção, use um dos seguintes cmdlets:

Salve a saída desses cmdlets em uma variável. Em seguida, especifique essas variáveis como uma matriz para esse parâmetro. Por exemplo, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Você também pode usar Get-CMDeploymentTypeDetectionClause para obter uma cláusula de detecção existente de outro aplicativo.

Type:DetectionClause[]
Aliases:AddDetectionClauses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddLanguage

Especifique uma matriz de marcas de idioma compatíveis com o tipo de implantação. Por exemplo, para adicionar russo (Rússia), especifique a marca ru-RU .

Para obter mais informações e uma lista de marcas de idioma, consulte Windows Referência do Identificador de Código de Idioma (LCID).

Type:String[]
Aliases:AddLanguages, Languages, Language
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddRequirement

-ApplicationId

Especifique a ID do aplicativo para esse tipo de implantação.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Especifique o nome do aplicativo para esse tipo de implantação.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Comentário

Especifique uma descrição opcional para o tipo de implantação.

Type:String
Aliases:AdministratorComment
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

-DeploymentTypeName

Especifique um nome de exibição para esse tipo de implantação.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DetectionClauseConnector

Ao usar o parâmetro GroupDetectionClauses para agrupar cláusulas de detecção, use esse parâmetro para especificar o conector.

O exemplo a seguir define o conector OR:@{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Type:Hashtable[]
Aliases:DetectionClauseConnectors
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

-EstimatedRuntimeMins

Especifique o tempo de instalação estimado, em minutos, desse tipo de implantação para o aplicativo. O Centro de Software exibe essa estimativa para o usuário antes da instalação do aplicativo.

Type:Int32
Aliases:EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Força

Força o comando a ser executado sem pedir confirmação do usuário.

Type:SwitchParameter
Aliases:ForceForUnknownPublisher
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceScriptDetection32Bit

Se você usar um script personalizado para detectar a presença desse tipo de implantação, de definir esse parâmetro como para executar o script como um processo de 32 bits em clientes de $true 64 bits.

Type:SwitchParameter
Aliases:Force32BitDetectionScript
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

-GroupDetectionClauses

Ao configurar regras para detectar a presença desse tipo de implantação, use esse parâmetro para agrupar cláusulas. Para criar uma cláusula de detecção, use um dos seguintes cmdlets:

Salve a saída desses cmdlets em uma variável. Em seguida, use o seguinte formato para agrupar cláusulas: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Dica

No console do Configuration Manager, quando você seleciona a ação Grupo, as cláusulas mostram parênteses antes e depois das cláusulas agrupadas.

Type:String[]
Aliases:GroupDetectionClausesByLogicalName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto application a ser configurar. Para obter esse objeto, use o cmdlet Get-CMApplication.

Type:IResultObject
Aliases:Application
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InstallationBehaviorType

Especifique o comportamento de instalação para este tipo de implantação:

  • InstallForUser: O cliente só instala o aplicativo para o usuário ao qual você implanta o aplicativo.
  • InstallForSystem: O cliente instala o aplicativo apenas uma vez. Está disponível para todos os usuários.
  • InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: Se você implantar o aplicativo em um dispositivo, o cliente o instalará para todos os usuários. Se você implantar o aplicativo em um usuário, o cliente só o instalará para esse usuário.
Type:InstallationBehaviorType
Accepted values:InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InstallTaskSequenceId

A ID da sequência de tarefas para instalar o aplicativo.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LogonRequirementType

Especifique o requisito para um usuário com assinatura:

  • OnlyWhenNoUserLoggedOn: Somente quando nenhum usuário estiver Windows.

  • OnlyWhenUserLoggedOn: Somente quando um usuário estiver inscreveu. Esta é a opção padrão.

  • WhetherOrNotUserLoggedOn: Se um usuário está ou não se inscreveu.

    Observação

    O valor WhereOrNotUserLoggedOn é preterido. Ele é substituído por WhetherOrNotUserLoggedOn .

Se você definir InstallationBehaviorType como InstallForUser , não será possível definir esse parâmetro.

Type:LogonRequirementType
Accepted values:OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumRuntimeMins

Especifique o tempo de duração máximo permitido do programa de implantação para este aplicativo. Definir um valor inteiro em minutos.

Type:Int32
Aliases:MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProductCode

Se o aplicativo usa Windows tecnologia installer, especifique um código de produto MSI para definir como o método de detecção. Quando você usa esse parâmetro, ele substitui quaisquer métodos de detecção existentes.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RebootBehavior

Especifique o comportamento pós-instalação:

  • BasedOnExitCode: Determine o comportamento com base nos códigos de retorno.

  • NoAction: Nenhuma ação específica.

  • ProgramReboot: O programa de instalação de software pode forçar a reinicialização do dispositivo.

  • ForceReboot: O cliente do Configuration Manager força uma reinicialização obrigatória do dispositivo.

Para obter mais informações sobre esses comportamentos, consulte Create applications in Configuration Manager.

Type:PostExecutionBehavior
Accepted values:BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveLanguage

Especifique uma matriz de idiomas com suporte a ser removido desse tipo de implantação.

Type:String[]
Aliases:RemoveLanguages
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRequirement

Especifique uma matriz de regras de requisitos a ser removido desse tipo de implantação.

Type:Rule[]
Aliases:RemoveRequirements
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequireUserInteraction

De definir esse parâmetro $true para permitir que os usuários visualizam e interajam com a instalação do tipo de implantação.

Type:SwitchParameter
Aliases:RequiresUserInteraction
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptFile

Especifique o arquivo de script a ser usado para detectar esse tipo de implantação. Use também o parâmetro ScriptLanguage.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptLanguage

Se você usar os parâmetros ScriptFile ou ScriptText, use esse parâmetro para especificar o idioma do script.

Type:ScriptLanguage
Aliases:ScriptType
Accepted values:PowerShell, VBScript, JavaScript
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptText

Especifique o texto de um script para detectar esse tipo de implantação. Use também o parâmetro ScriptLanguage.

Para obter mais informações, consulte Sobre métodos personalizados de detecção de script.

Type:String
Aliases:ScriptContent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SlowNetworkDeploymentMode

Quando um cliente usa um ponto de distribuição de um grupo de limite de vizinhos ou o grupo de limite de site padrão, especifique a opção de implantação:

  • DoNothing: Não baixe conteúdo
  • Download: Baixe o conteúdo do ponto de distribuição e execute localmente
Type:ContentHandlingMode
Accepted values:DoNothing, Download
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UninstallTaskSequenceId

A ID da sequência de tarefas para desinstalar o aplicativo.

Type:String
Aliases:UninstallId, UninstallTaskSequencePackageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserInteractionMode

Especifique a visibilidade do programa de instalação:

  • Normal: O tipo de implantação é executado no modo normal com base nos padrões do sistema e do programa. Esse modo é o padrão.
  • Minimized: O tipo de implantação é executado minimizado em dispositivos cliente. Os usuários podem ver a atividade de instalação na área de notificação ou na barra de tarefas.
  • Maximized: O tipo de implantação é executado maximizada em dispositivos cliente. Os usuários veem todas as atividades de instalação.
  • Hidden: O tipo de implantação é executado oculto em dispositivos cliente. Os usuários não veem nenhuma atividade de instalação.
Type:UserInteractionMode
Aliases:InstallationProgramVisibility
Accepted values:Normal, Minimized, Maximized, Hidden
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object