Set-CMApplicationDeployment
Configuración de una implementación de aplicación
Syntax
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 Configuration Manager, por ejemploPS 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.
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationId
Especifica el identificador de una aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationName
Especifica el nombre de una aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique el identificador de la colección en la que se implementa la aplicación. Por ejemplo, "SMS00004"
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique el nombre de la colección en la que se implementa la aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
Especifica un comentario opcional para la implementación.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
Establezca este parámetro $true
en para habilitar el modo de mantenimiento de System Center Operations Manager para esta implementación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
Establezca este parámetro $true
en para habilitar la aplicación diferida.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | IResultObject |
Aliases: | Application, DeploymentSummary, Assignment |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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, este cmdlet no puede generar ninguna salida.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDeploy
Indica si se va a implementar previamente la aplicación en el dispositivo principal del usuario.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RaiseMomAlertsOnFailure
Indica si se va a crear una alerta de Operations Manager si un cliente no puede instalar la aplicación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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).
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireApproval
Si establece este parámetro $true
en , un administrador debe aprobar una solicitud para esta aplicación en el dispositivo.
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
Especifica qué zona horaria se va a usar:
LocalTime
: use la hora local.UTC
: use la hora universal coordinada (UTC).
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de