Compartir a través de


Set-CMTaskSequenceDeploymentType

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

Sintaxis

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, consulte Tipo de implementación de secuencia de tareas.

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

  • -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 -UninstallCommand en el cmdlet MSI.

Ejemplos

Ejemplo 1: Modificación de 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 tardará aproximadamente 14 minutos en completarse y solo se ejecutará cuando no haya ningún usuario que haya iniciado sesión en 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

-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 siguientes cmdlets:

Guarde la salida 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.

Tipo:DetectionClause[]
Alias:AddDetectionClauses
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 Referencia del identificador de código de lenguaje (LCID) de Windows.

Tipo:String[]
Alias:AddLanguages, Languages, Language
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AddRequirement

-Application

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

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ApplicationId

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

Tipo:Int32
Alias:CI_ID, CIId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ApplicationName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Comment

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

Tipo:String
Alias:AdministratorComment
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeploymentTypeName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DetectionClauseConnector

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

En el ejemplo siguiente se define el conector OR : @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Tipo:Hashtable[]
Alias:DetectionClauseConnectors
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EstimatedRuntimeMins

Especifique el tiempo de instalación estimado, 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.

Tipo:Int32
Alias:EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga al comando a ejecutarse sin pedir confirmación del usuario.

Tipo:SwitchParameter
Alias:ForceForUnknownPublisher
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceScriptDetection32Bit

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

Tipo:Boolean
Alias:Force32BitDetectionScript
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GroupDetectionClauses

Cuando configure 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 siguientes cmdlets:

Guarde la salida 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 Agrupar , las cláusulas muestran paréntesis antes y después de las cláusulas agrupadas.

Tipo:String[]
Alias:GroupDetectionClausesByLogicalName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

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

Tipo:IResultObject
Alias:DeploymentType
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 en el 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.
Tipo:InstallationBehaviorType
Valores aceptados:InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstallTaskSequenceId

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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: indica si un usuario ha iniciado sesión o no.

    Nota:

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

Si establece InstallationBehaviorType enInstallForUser, no puede establecer este parámetro.

Tipo:LogonRequirementType
Valores aceptados:OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaximumRuntimeMins

Especifique el tiempo de ejecución máximo permitido del programa de implementación para esta aplicación. Establezca un valor entero en minutos.

Tipo:Int32
Alias:MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewName

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

Tipo:String
Alias:NewDeploymentTypeName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProductCode

Si la aplicación usa la tecnología de Windows Installer, especifique un código de producto MSI para establecer como método de detección. Cuando se usa este parámetro, se sobrescriben los métodos de detección existentes.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RebootBehavior

Especifique el comportamiento posterior a la instalación:

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

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

  • ProgramReboot: el programa de instalación de software podría 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, consulte Creación de aplicaciones en Configuration Manager.

Tipo:PostExecutionBehavior
Valores aceptados:BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveDetectionClause

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

Tipo:String[]
Alias:RemoveDetectionClauses
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveLanguage

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

Tipo:String[]
Alias:RemoveLanguages
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveRequirement

Especifique una matriz de reglas de requisitos que se van a quitar de este tipo de implementación.

Tipo:Rule[]
Alias:RemoveRequirements
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RequireUserInteraction

Establezca este parámetro $true en para permitir que los usuarios vean e interactúen con la instalación del tipo de implementación.

Tipo:Boolean
Alias:RequiresUserInteraction
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScriptFile

Especifique el archivo de script que se va a usar para detectar este tipo de implementación. Use también el parámetro ScriptLanguage .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScriptLanguage

Si usa los parámetros ScriptFile o ScriptText , use este parámetro para especificar el lenguaje de script.

Tipo:ScriptLanguage
Alias:ScriptType
Valores aceptados:PowerShell, VBScript, JavaScript
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScriptText

Especifique el texto de un script para detectar este tipo de implementación. Use también el parámetro ScriptLanguage .

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

Tipo:String
Alias:ScriptContent, Script
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SlowNetworkDeploymentMode

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

  • DoNothing: no descargar contenido
  • Download: descargue contenido del punto de distribución y ejecute localmente.
Tipo:ContentHandlingMode
Valores aceptados:DoNothing, Download
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UninstallTaskSequenceId

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

Tipo:String
Alias:ContentLocation, UninstallId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 los dispositivos cliente. Es posible que los usuarios vean la actividad de instalación en el área de notificación o la barra de tareas.
  • Maximized: el tipo de implementación se ejecuta maximizado en los dispositivos cliente. Los usuarios ven toda la actividad de instalación.
  • Hidden: el tipo de implementación se ejecuta oculto en los dispositivos cliente. Los usuarios no ven ninguna actividad de instalación.
Tipo:UserInteractionMode
Alias:InstallationProgramVisibility
Valores aceptados:Normal, Minimized, Maximized, Hidden
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object