Set-CMApplicationDeployment

Configuración de una implementación de aplicación

Sintaxis

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   -InputObject <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationId <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationName <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-CMApplicationDeployment modifica las propiedades de una implementación de aplicación en Configuration Manager. Para obtener más información, consulte Implementación de aplicaciones con Configuration Manager.

Para especificar una implementación de aplicación que se va a modificar, especifique el nombre de la colección y la aplicación. Puede especificar una aplicación por nombre o identificador. También puede usar el cmdlet Get-CMApplication para obtener una aplicación que modificar.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Modificación de la disponibilidad y la fecha límite de una implementación de aplicación

Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)

Este comando modifica una implementación de aplicación para una aplicación denominada Track System 2011 para una colección denominada Todos los usuarios. El comando especifica la fecha actual para cuando la aplicación está disponible. También configura la fecha límite de implementación para 30 días en el futuro.

Parámetros

-AllowRepairApp

Use este parámetro para configurar la opción de reparación de la aplicación al crear una implementación para una aplicación.

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

-ApplicationId

Especifica el identificador de una aplicación.

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

-ApplicationName

Especifica el nombre de una aplicación.

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

-AutoCloseExecutable

A partir de la versión 2107, establezca este parámetro $true en para habilitar la configuración de implementación de aplicaciones para los comportamientos de instalación. A continuación, use el cmdlet Add-CMDeploymentTypeInstallBehavior para agregar un archivo ejecutable y comprobar que no se está ejecutando para que la instalación se realice correctamente.

Establezca este parámetro $false en para deshabilitar esta opción en las situaciones siguientes:

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

-AvailableDateTime

Especifique un objeto DateTime para cuando esta implementación esté disponible. Para obtener este objeto, use el cmdlet integrado Get-Date .

Use DeadlineDateTime para especificar la asignación de implementación o la fecha límite.

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

-Collection

Especifique un objeto de colección en el que se implementa la aplicación. Para obtener este objeto, use el cmdlet Get-CMCollection .

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

-CollectionId

Especifique el identificador de la colección en la que se implementa la aplicación. Por ejemplo, "SMS00004".

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

-CollectionName

Especifique el nombre de la colección en la que se implementa la aplicación.

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

-Comment

Especifica un comentario opcional para la implementación.

Tipo:String
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CreateAlertBaseOnPercentFailure

Indica si se va a crear una alerta para un porcentaje de las aplicaciones que no se pueden implementar. Para especificar el valor de porcentaje, use el parámetro FailParameterValue .

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

-CreateAlertBaseOnPercentSuccess

Indica si se va a crear una alerta para un porcentaje de las aplicaciones que se implementan correctamente. Para especificar el valor de porcentaje, use el parámetro SuccessParameterValue .

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

-DeadlineDateTime

Especifique un objeto DateTime para cuando se asigne esta implementación, también conocida como fecha límite. Para obtener este objeto, use el cmdlet integrado Get-Date .

Use -AvailableDateTime para especificar cuándo está disponible la implementación.

Tipo:DateTime
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

-EnableMomAlert

Establezca este parámetro $true en para habilitar el modo de mantenimiento de System Center Operations Manager para esta implementación.

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

-EnableSoftDeadline

Establezca este parámetro $true en para habilitar la aplicación diferida.

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

-FailParameterValue

Especifica el porcentaje de instalación de aplicaciones con errores que provoca una alerta. Especifique un entero entre 1 y 100. Para habilitar esta alerta, establezca el parámetro $TrueCreatAlertBaseOnPercentFailure en .

Tipo:Int32
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

-InputObject

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

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

-OverrideServiceWindow

Indica si la implementación tiene lugar incluso si está programada fuera de una ventana de mantenimiento. Una ventana de mantenimiento es un período de tiempo especificado que se usa para el mantenimiento y las actualizaciones del equipo. Si este valor es $True, Configuration Manager implementa la aplicación incluso si la hora programada se encuentra fuera de la ventana de mantenimiento. Si este valor es $False, Configuration Manager no implementa la aplicación fuera de la ventana. Espera hasta que se puede implementar en una ventana disponible.

Tipo:Boolean
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

-PersistOnWriteFilterDevice

Indica si se deben habilitar los filtros de escritura para dispositivos incrustados. Para un valor de $True, el dispositivo confirma los cambios durante una ventana de mantenimiento. Esta acción requiere un reinicio. Para un valor de $False, el dispositivo guarda los cambios en una superposición y los confirma más adelante.

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

-PostponeDateTime

Cuando establezca CreateAlertBaseOnPercentSuccess$trueen , use este parámetro para especificar un objeto DateTime . Configuration Manager crea una alerta de implementación cuando el umbral es menor que SuccessParameterValue después de esta fecha.

Para obtener este objeto, use el cmdlet integrado Get-Date .

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

-PreDeploy

Indica si se va a implementar previamente la aplicación en el dispositivo principal del usuario.

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

-RaiseMomAlertsOnFailure

Indica si se va a crear una alerta de Operations Manager si un cliente no puede instalar la aplicación.

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

-RebootOutsideServiceWindow

Indica si un equipo se reinicia fuera de una ventana de mantenimiento. Una ventana de mantenimiento es un período de tiempo especificado que se usa para el mantenimiento y las actualizaciones del equipo. Si este valor es $True, cualquier reinicio necesario tiene lugar sin tener en cuenta las ventanas de mantenimiento. Si este valor es $False, el equipo no se reinicia fuera de una ventana de mantenimiento.

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

-ReplaceToastNotificationWithDialog

Cuando el software necesario esté disponible en el cliente, establezca este parámetro $true en para reemplazar las notificaciones del sistema predeterminadas por una ventana de diálogo. Es false de forma predeterminada. Para obtener más información, vea Replace toast notifications with dialog window (Reemplazar notificaciones del sistema por ventana de diálogo).

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

-RequireApproval

Si establece este parámetro $trueen , un administrador debe aprobar una solicitud para esta aplicación en el dispositivo.

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

-SendWakeUpPacket

Indica si se va a enviar un paquete de reactivación a los equipos antes de que comience la implementación. Si este valor es $True, Configuration Manager intenta reactivar un equipo de suspensión. Si este valor es $False, no reactiva los equipos de suspensión. Para que los equipos se activen, primero debe configurar Wake On LAN.

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

-SuccessParameterValue

Especifica el porcentaje de instalación correcta de la aplicación que provoca una alerta. Especifique un entero entre 0 y 99. Para habilitar esta alerta, establezca el parámetro CreateAlertBaseOnPercentSuccess como $True.

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

-TimeBaseOn

Especifica qué zona horaria se va a usar:

  • LocalTime: use la hora local.
  • UTC: use la hora universal coordinada (UTC).
Tipo:TimeType
Valores aceptados:LocalTime, Utc
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UseMeteredNetwork

Indica si se permite a los clientes descargar contenido a través de una conexión a Internet de uso medido después de la fecha límite, lo que puede suponer gastos adicionales.

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

-UserNotification

Especifica el tipo de notificación de usuario.

  • DisplayAll: se muestra en el Centro de software y se muestran todas las notificaciones.
  • DisplaySoftwareCenterOnly: se muestra en el Centro de software y solo se muestran las notificaciones de reinicios del equipo.
  • HideAll: ocultar en el Centro de software y todas las notificaciones.
Tipo:UserNotificationType
Valores aceptados:DisplayAll, DisplaySoftwareCenterOnly, HideAll
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_ApplicationAssignment clase WMI de servidor.