Set-CMTaskSequenceDeploymentType

Artigo
08/17/2021

SYNOPSIS

Configurar um tipo de implementação de sequência de tarefa numa aplicação.

SYNTAX

ByAppName (Padrão)

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

ByAppValue

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

ByAppId

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

ByDTValue

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

DESCRIPTION

Aplica-se à versão 2006 e mais tarde. Utilize este cmdlet para configurar um tipo de implementação de sequência de tarefa numa aplicação. Para obter mais informações, consulte o tipo de implementação da sequência de tarefas.

Este cmdlet tem sintaxe semelhante à do tipo de implementação MSI cmdlet Set-CMMsiDeploymentType. As principais diferenças são os seguintes parâmetros:

-InstallTaskSequenceId <string> (obrigatório): o ID da sequência de tarefas para instalar a aplicação
-UninstallTaskSequenceId <string> (opcional): o ID da sequência de tarefa para desinstalar a aplicação

Estes dois parâmetros dizem respeito às opções de sequência de tarefas do tipo de implantação. Substituem os -InstallCommand parâmetros e -UninstallCommand parâmetros no cmdlet MSI.

EXAMPLES

Exemplo 1: Modificar um tipo de implementação de sequência de tarefa

Este comando altera o nome do tipo de implantação da instalação Complex para a instalação Advanced. Adiciona inglês (Estados Unidos) en-US e chinês (Simplificado) zh-CN como línguas apoiadas. Especifica que a instalação levará aproximadamente 14 minutos para ser concluída, e só funcionará quando nenhum utilizadores estiver assinado em Windows.

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

Para outros exemplos com regras de requisito e métodos de deteção, consulte Set-CMScriptDeploymentType e Add-CMMsiDeploymentType.

PARAMETERS

-AddDetectionClause

Especifique um conjunto de cláusulas de método de deteção para este tipo de implantação. Para criar uma cláusula de deteção, utilize um dos seguintes cmdlets:

Guarde a saída destes cmdlets numa variável. Em seguida, especifique essas variáveis como uma matriz para este parâmetro. Por exemplo, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Também pode utilizar o Get-CMDeploymentTypeDetectionClause para obter uma cláusula de deteção existente a partir de outra aplicação.

Type: DetectionClause[]
Parameter Sets: (All)
Aliases: AddDetectionClauses

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

-AddLanguage

Especifique uma série de etiquetas linguísticas que o tipo de implementação suporta. Por exemplo, para adicionar russo (Rússia), especifique a etiqueta ru-RU .

Para obter mais informações e uma lista de etiquetas linguísticas, consulte Windows referência do identificador de códigos de língua (LCID).

Type: String[]
Parameter Sets: (All)
Aliases: AddLanguages, Languages, Language

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

-AddRequirement

Especifique uma matriz de objetos de requisito para o tipo de implantação. Para criar um objeto de regra de exigência, utilize um dos seguintes cmdlets:

Type: Rule[]
Parameter Sets: (All)
Aliases:

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

-Aplicação

Especifique um objeto de aplicação para este tipo de implementação. Para obter este objeto, utilize o cmdlet Get-CMApplication.

Type: IResultObject
Parameter Sets: ByAppValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ApplicationId

Especifique o ID da aplicação para este tipo de implantação.

Type: Int32
Parameter Sets: ByAppId
Aliases: CI_ID, CIId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Nome de aplicação

Especifique o nome da aplicação para este tipo de implantação.

Type: String
Parameter Sets: ByAppName
Aliases:

Required: True
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
Parameter Sets: (All)
Aliases: AdministratorComment

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-ImplantaçãoTypeName

Especifique o nome do tipo de implantação para configurar.

Type: String
Parameter Sets: ByAppName, ByAppValue, ByAppId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DetecçãoClauseConnector

Quando utilizar o parâmetro GroupDetectionClauses para as cláusulas de deteção de grupo, utilize este parâmetro para especificar o conector.

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

Type: Hashtable[]
Parameter Sets: (All)
Aliases: DetectionClauseConnectors

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EstimativaruntimeMins

Especifique o tempo estimado de instalação, em minutos, deste tipo de implantação para a aplicação. O Software Center exibe esta estimativa ao utilizador antes da instalação da aplicação.

Type: Int32
Parameter Sets: (All)
Aliases: EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes

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

-Force

Força o comando a funcionar sem pedir confirmação do utilizador.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ForceForUnknownPublisher

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

-ForceScriptDetection32Bit

Se utilizar um script personalizado para detetar a presença deste tipo de implementação, desa um parâmetro $true para executar o script como um processo de 32 bits em clientes de 64 bits.

Type: Boolean
Parameter Sets: (All)
Aliases: Force32BitDetectionScript

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GroupDetectionClauses

Quando configurar regras para detetar a presença deste tipo de implantação, utilize este parâmetro para agrupar cláusulas. Para criar uma cláusula de deteção, utilize um dos seguintes cmdlets:

Guarde a saída destes cmdlets numa variável. Em seguida, utilize o seguinte formato para as cláusulas de grupo: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Dica

Na consola 'Gestor de Configuração', quando seleciona a ação do Grupo, as cláusulas mostram parênteses antes e depois das cláusulas agrupadas.

Type: String[]
Parameter Sets: (All)
Aliases: GroupDetectionClausesByLogicalName

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

-InputObject

Especifique um objeto tipo de implantação para configurar. Para obter este objeto, utilize o cmdlet Get-CMDeploymentType.

Type: IResultObject
Parameter Sets: ByDTValue
Aliases: DeploymentType

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-InstalarTaskSequenceId

O ID da sequência de tarefas para instalar a aplicação.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Instalação ComportamentoType

Especifique o comportamento de instalação deste tipo de implantação:

InstallForUser: O cliente instala apenas a aplicação para o utilizador a quem implementa a aplicação.
InstallForSystem: O cliente instala a aplicação apenas uma vez. Está disponível para todos os utilizadores.
InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: Se implementar a aplicação num dispositivo, o cliente instala-a para todos os utilizadores. Se implementar a aplicação para um utilizador, o cliente apenas a instala para esse utilizador.

Type: InstallationBehaviorType
Parameter Sets: (All)
Aliases:
Accepted values: InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser

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

-LogonRequirementType

Especificar o requisito para um utilizador inscrito:

OnlyWhenNoUserLoggedOn: Só quando nenhum utilizador estiver inscrito em Windows.
OnlyWhenUserLoggedOn: Só quando um utilizador é inscrito. Esta é a opção predefinida.
WhetherOrNotUserLoggedOn: Se um utilizador está ou não inscrito.

Nota

O valor WhereOrNotUserLoggedOn é depreciado. É substituído WhetherOrNotUserLoggedOn por.

Se definir o Modo de Comportamento de Instalação, não pode definir este InstallForUser parâmetro.

Type: LogonRequirementType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn

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

-MáximoRuntimeMins

Especifique o tempo máximo de funcionamento permitido do programa de implantação para esta aplicação. Desajei um valor inteiro em minutos.

Type: Int32
Parameter Sets: (All)
Aliases: MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes

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

-Novo Nome

Especifique um novo nome para renomear este tipo de implementação.

Type: String
Parameter Sets: (All)
Aliases: NewDeploymentTypeName

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

- PassThru

Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Código de Produto

Se a aplicação utilizar Windows tecnologia Installer, especifique um código de produto MSI para definir como método de deteção. Quando se utiliza este parâmetro, substitui os métodos de deteção existentes.

Type: String
Parameter Sets: (All)
Aliases:

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

-RebootBehavior

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

BasedOnExitCode: Determinar o comportamento com base em códigos de devolução.
NoAction: Nenhuma ação específica.
ProgramReboot: O programa de instalação do software pode forçar o reinício do dispositivo.
ForceReboot: O cliente do Gestor de Configuração forçará um recomeça obrigatório do dispositivo.

Para obter mais informações sobre estes comportamentos, consulte Criar aplicações no Gestor de Configuração.

Type: PostExecutionBehavior
Parameter Sets: (All)
Aliases:
Accepted values: BasedOnExitCode, NoAction, ForceReboot, ProgramReboot

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

-Remover Remoção deDetecçãoClause

Especifique uma série de cláusulas de método de deteção para remover.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveDetectionClauses

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

-Remover aguagem

Especifique uma variedade de idiomas suportados para remover deste tipo de implantação.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveLanguages

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

-Remover o Acordo de Remoção

Especifique um conjunto de regras de requisito para remover deste tipo de implementação.

Type: Rule[]
Parameter Sets: (All)
Aliases: RemoveRequirements

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

-Requerinteracção do 2.000

Desa esta definição deste parâmetro $true para permitir que os utilizadores vejam e interajam com a instalação do tipo de implantação.

Type: Boolean
Parameter Sets: (All)
Aliases: RequiresUserInteraction

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

-ScriptFile

Especifique o ficheiro de script para detetar este tipo de implementação. Utilize também o parâmetro ScriptLanguage.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScriptLanguage

Se utilizar os parâmetros ScriptFile ou ScriptText, utilize este parâmetro para especificar o idioma do script.

Type: ScriptLanguage
Parameter Sets: (All)
Aliases: ScriptType
Accepted values: PowerShell, VBScript, JavaScript

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

-ScriptText

Especifique o texto de um script para detetar este tipo de implementação. Utilize também o parâmetro ScriptLanguage.

Para obter mais informações, consulte sobre os métodos de deteção de scripts personalizados.

Type: String
Parameter Sets: (All)
Aliases: ScriptContent, Script

Required: False
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 fronteira vizinho ou do grupo de fronteira do local padrão, especifique a opção de implementação:

DoNothing: Não descarregue conteúdo
Download: Descarregue o conteúdo do ponto de distribuição e corra localmente

Type: ContentHandlingMode
Parameter Sets: (All)
Aliases:
Accepted values: DoNothing, Download

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

-DesinstalarTaskSequenceId

O ID da sequência de tarefas para desinstalar a aplicação.

Type: String
Parameter Sets: (All)
Aliases: ContentLocation, UninstallId

Required: False
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 funciona no modo normal com base nas predefinições do sistema e do programa. Este é o modo predefinido.
Minimized: O tipo de implantação é minimizado em dispositivos clientes. Os utilizadores podem ver a atividade de instalação na área de notificação ou na barra de tarefas.
Maximized: O tipo de implantação é maximizado em dispositivos clientes. Os utilizadores vêem toda a atividade de instalação.
Hidden: O tipo de implantação é ocultada em dispositivos clientes. Os utilizadores não vêem nenhuma atividade de instalação.

Type: UserInteractionMode
Parameter Sets: (All)
Aliases: InstallationProgramVisibility
Accepted values: Normal, Minimized, Maximized, Hidden

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Add-CMTaskSequenceDeploymentType

Obter-CMDeploymentType

Remover-CMDeploymentType

Get-CMApplication

Tipo de implantação de sequência de tarefa

Partilhar via