Set-CMTaskSequenceDeploymentType

Módulo:

ConfigurationManager

Configurar un tipo de implementación de secuencia de tareas en una aplicación.

Syntax

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>]

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>]

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>]

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

Se aplica a la versión 2006 y versiones posteriores. Use este cmdlet para configurar un tipo de implementación de secuencia de tareas en una aplicación. Para obtener más información, vea Tipo de implementación de secuencia de tareas.

Este cmdlet tiene una sintaxis similar a la del cmdlet Set-CMMsiDeploymentTypede tipo de implementación MSI. Las principales diferencias son los siguientes parámetros:

• -InstallTaskSequenceId <string> (obligatorio): el identificador de la secuencia de tareas para instalar la aplicación

• -UninstallTaskSequenceId <string> (opcional): el identificador de la secuencia de tareas para desinstalar la aplicación

Estos dos parámetros se relacionan con las opciones de secuencia de tareas de tipo de implementación. Reemplazan los -InstallCommand parámetros y en el cmdlet -UninstallCommand MSI.

Ejemplos

Ejemplo 1: Modificar un tipo de implementación de secuencia de tareas

Este comando cambia el nombre del tipo de implementación de Instalación compleja a Instalación avanzada. Agrega inglés (Estados Unidos) ( en-US ) y chino (simplificado) ( zh-CN ) como idiomas admitidos. Especifica que la instalación tarda aproximadamente 14 minutos en completarse y solo se ejecutará cuando ningún usuario haya iniciado sesión 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 obtener otros ejemplos con reglas de requisitos y métodos de detección, vea Set-CMScriptDeploymentType y Add-CMMsiDeploymentType.

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-AddDetectionClause

Especifique una matriz de cláusulas de método de detección para este tipo de implementación. Para crear una cláusula de detección, use uno de los cmdlets siguientes:

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

Guarde el resultado de estos cmdlets en una variable. A continuación, especifique esas variables como una matriz para este parámetro. Por ejemplo, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

También puede usar Get-CMDeploymentTypeDetectionClause para obtener una cláusula de detección existente de otra aplicación.

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

-AddLanguage

Especifique una matriz de etiquetas de idioma que admita el tipo de implementación. Por ejemplo, para agregar ruso (Rusia), especifique la etiqueta ru-RU .

Para obtener más información y una lista de etiquetas de idioma, vea Windows Language Code Identifier (LCID) Reference.

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

-AddRequirement

Especifique una matriz de objetos de requisito para el tipo de implementación. Para crear un objeto de regla de requisito, use uno de los cmdlets siguientes:

• New-CMRequirementRuleActiveDirectorySiteValue
• New-CMRequirementRuleBooleanValue
• New-CMRequirementRuleCMSiteValue
• New-CMRequirementRuleCommonValue
• New-CMRequirementRuleDeviceOwnershipValue
• New-CMRequirementRuleExistential
• New-CMRequirementRuleExpression
• New-CMRequirementRuleFileAttributeValue
• New-CMRequirementRuleFilePermissionValue
• New-CMRequirementRuleFreeDiskSpaceValue
• New-CMRequirementRuleInputTypeValue
• New-CMRequirementRuleOperatingSystemLanguageValue
• New-CMRequirementRuleOperatingSystemValue
• New-CMRequirementRuleOUValue
• New-CMRequirementRuleRegistryKeyPermissionValue
• New-CMRequirementRuleScreenResolutionValue

A partir de la versión 2111, puede usar el cmdlet Get-CMDeploymentTypeRequirement para copiar reglas de otro tipo de implementación.

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

-Application

Especifique un objeto de aplicación para este tipo de implementación. Para obtener este objeto, use el cmdlet Get-CMApplication.

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

-ApplicationId

Especifique el identificador de la aplicación para este tipo de implementación.

Type:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

Especifique el nombre de la aplicación para este tipo de implementación.

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

-Comment

Especifique una descripción opcional para el tipo de implementación.

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

-DeploymentTypeName

Especifique el nombre del tipo de implementación que se debe configurar.

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

-DetectionClauseConnector

Cuando use el parámetro GroupDetectionClauses para las cláusulas de detección de grupos, use este parámetro para especificar el conector.

En el siguiente ejemplo se define el 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 los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-EstimatedRuntimeMins

Especifique el tiempo estimado de instalación, en minutos, de este tipo de implementación para la aplicación. El Centro de software muestra esta estimación al usuario antes de que se instale la aplicación.

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

-Force

Fuerza al comando a ejecutarse sin pedir confirmación de usuario.

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

-ForceScriptDetection32Bit

Si usa un script personalizado para detectar la presencia de este tipo de implementación, establezca este parámetro para que ejecute el script como un proceso de 32 bits en clientes de $true 64 bits.

Type:	Boolean
Aliases:	Force32BitDetectionScript
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-GroupDetectionClauses

Al configurar reglas para detectar la presencia de este tipo de implementación, use este parámetro para agrupar cláusulas. Para crear una cláusula de detección, use uno de los cmdlets siguientes:

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

Guarde el resultado de estos cmdlets en una variable. A continuación, use el siguiente formato para agrupar cláusulas: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Sugerencia

En la consola de Configuration **** Manager, al seleccionar la acción Grupo, las cláusulas muestran paréntesis antes y después de las cláusulas agrupadas.

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

-InputObject

Especifique un objeto de tipo de implementación que se debe configurar. Para obtener este objeto, use el cmdlet Get-CMDeploymentType.

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

-InstallationBehaviorType

Especifique el comportamiento de instalación de este tipo de implementación:

• InstallForUser: el cliente solo instala la aplicación para el usuario al que implementa la aplicación.
• InstallForSystem: el cliente instala la aplicación solo una vez. Está disponible para todos los usuarios.
• InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: si implementa la aplicación en un dispositivo, el cliente la instala para todos los usuarios. Si implementa la aplicación en un usuario, el cliente solo la instala para ese usuario.

Type:	InstallationBehaviorType
Accepted values:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallTaskSequenceId

Identificador de la secuencia de tareas para instalar la aplicación.

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

-LogonRequirementType

Especifique el requisito para un usuario que ha iniciado sesión:

• OnlyWhenNoUserLoggedOn: solo cuando ningún usuario ha iniciado sesión en Windows.

• OnlyWhenUserLoggedOn: solo cuando un usuario ha iniciado sesión. Esta es la opción predeterminada.

• WhetherOrNotUserLoggedOn: si un usuario ha iniciado sesión o no.

  Nota

  El valor WhereOrNotUserLoggedOn está en desuso. Se reemplaza por WhetherOrNotUserLoggedOn .

Si establece InstallationBehaviorType en InstallForUser , no puede establecer este 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 el tiempo máximo de ejecución permitido del programa de implementación para esta aplicación. Establece un valor entero en minutos.

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

-NewName

Especifique un nuevo nombre para cambiar el nombre de este tipo de implementación.

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

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, es posible que este cmdlet no genere ningún resultado.

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

-ProductCode

Si la aplicación usa Windows installer, especifique un código de producto MSI para establecer como método de detección. Cuando se usa este parámetro, se sobrescribe cualquier método de detección existente.

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

-RebootBehavior

Especifique el comportamiento posterior a la instalación:

• BasedOnExitCode: determine el comportamiento en función de los códigos devueltos.

• NoAction: No hay ninguna acción específica.

• ProgramReboot: el programa de instalación de software puede forzar el reinicio del dispositivo.

• ForceReboot: el cliente de Configuration Manager forzará un reinicio obligatorio del dispositivo.

Para obtener más información sobre estos comportamientos, vea 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

-RemoveDetectionClause

Especifique una matriz de cláusulas de método de detección que se deben quitar.

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

-RemoveLanguage

Especifique una matriz de idiomas admitidos para quitar de este tipo de implementación.

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

-RemoveRequirement

Especifique una matriz de reglas de requisitos para quitar de este tipo de implementación.

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

-RequireUserInteraction

Establezca este parámetro para $true permitir a los usuarios ver e interactuar con la instalación del tipo de implementación.

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

-ScriptFile

Especifique el archivo de script que se usará para detectar este tipo de implementación. También use el parámetro ScriptLanguage.

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

-ScriptLanguage

Si usa los parámetros ScriptFile o ScriptText, use este parámetro para especificar el idioma del 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 el texto de un script para detectar este tipo de implementación. También use el parámetro ScriptLanguage.

Para obtener más información, vea Acerca de los métodos de detección de scripts personalizados.

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

-SlowNetworkDeploymentMode

Cuando un cliente usa un punto de distribución de un grupo de límites de vecinos o el grupo de límites de sitio predeterminado, especifique la opción de implementación:

• DoNothing: No descargar contenido
• Download: descargar contenido desde el punto de distribución y ejecutarlo localmente

Type:	ContentHandlingMode
Accepted values:	DoNothing, Download
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UninstallTaskSequenceId

Identificador de la secuencia de tareas para desinstalar la aplicación.

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

-UserInteractionMode

Especifique la visibilidad del programa de instalación:

• Normal: el tipo de implementación se ejecuta en el modo normal en función de los valores predeterminados del sistema y del programa. Este modo es el predeterminado.
• Minimized: el tipo de implementación se ejecuta minimizado en dispositivos cliente. Es posible que los usuarios vean la actividad de instalación en el área de notificación o en la barra de tareas.
• Maximized: el tipo de implementación se ejecuta maximizado en dispositivos cliente. Los usuarios ven toda la actividad de instalación.
• Hidden: el tipo de implementación se ejecuta oculto en dispositivos cliente. Los usuarios no ven ninguna actividad de instalación.

Type:	UserInteractionMode
Aliases:	InstallationProgramVisibility
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Add-CMTaskSequenceDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• Tipo de implementación de secuencia de tareas