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:
- Cuando se usa el cmdlet Remove-CMDeploymentTypeInstallBehavior para quitar todos los archivos ejecutables
- No quiere que la implementación compruebe si hay ejecutables en ejecución.
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 $True
CreatAlertBaseOnPercentFailure 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$true
en , 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 $true
en , 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.