Compartir a través de

New-CMApplicationDeployment

  • Referencia
Módulo:
ConfigurationManager

Cree una implementación de aplicación.

Sintaxis

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-CMApplicationDeployment crea una implementación de aplicación. Para obtener más información, consulte Implementación de aplicaciones con Configuration Manager.

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: Instalación de una aplicación

Este comando crea una nueva implementación para Visual Studio 2019 en la colección Developers Workstation. Instala la aplicación y es necesaria. Tanto la fecha como la fecha límite disponibles son la misma hora del pasado, por lo que en cuanto el cliente recibe esta directiva, instala la aplicación.

New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required

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

-ApprovalRequired

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

-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 esta 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 esta aplicación.

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

-Comment

Especifique un comentario opcional para esta 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: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
Alias:SupersedenceDeadlineDateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeployAction

Especifique la acción de implementación, ya sea para instalar o desinstalar la aplicación. Si las implementaciones de la competencia tienen como destino el mismo dispositivo, la acción Instalar tiene prioridad.

Tipo:DeployActionType
Valores aceptados:Install, Uninstall
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeployPurpose

Especifique el propósito de implementación:

  • Available: el usuario ve la aplicación en el Centro de software. Pueden instalarlo a petición.

  • Required: el cliente instala automáticamente la aplicación según la programación establecida. Si la aplicación no está oculta, un usuario puede realizar un seguimiento de su estado de implementación. También pueden usar el Centro de software para instalar la aplicación antes de la fecha límite.

Tipo:DeployPurposeType
Valores aceptados:Available, Required
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableContentDependencyDetection

Agregue este parámetro para no distribuir automáticamente el contenido de las aplicaciones dependientes.

Tipo:SwitchParameter
Alias:DisableDetectAssociatedContentDependencies
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

-DistributeCollectionName

El sitio distribuye contenido a los puntos de distribución asociados a este nombre de colección.

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

-DistributeContent

Agregue este parámetro si primero necesita distribuir el contenido de la aplicación.

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

-DistributionPointGroupName

Para distribuir el contenido de la aplicación, especifique el nombre de un grupo de puntos de distribución.

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

-DistributionPointName

Para distribuir el contenido de la aplicación, especifique el nombre de un punto de distribución.

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

-GenerateScomAlertOnFailure

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

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

-Id

Especifique el identificador de la aplicación que se va a implementar.

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

-InputObject

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

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

-Name

Especifique el nombre de la aplicación que se va a implementar.

Tipo:String
Alias:LocalizedDisplayName, ApplicationName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
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

-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

-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

-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

-Simulation

Agregue este parámetro para crear una simulación de implementación. Para obtener más información, consulte Simulación de implementaciones de aplicaciones con Configuration Manager.

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

-UpdateSupersedence

Para una implementación disponible, use este parámetro para especificar la fecha límite de instalación para actualizar los usuarios o dispositivos que tienen instalada la aplicación reemplazada. Use DeadlineDateTime para especificar una hora específica; de lo contrario, es lo antes posible después de AvailableDateTime.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object