New-CMApplicationDeployment
Crear una implementación de aplicación.
Syntax
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, vea Deploy applications with Configuration Manager.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Instalar 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 necesario. La fecha y la fecha límite disponibles son la misma hora del pasado, por lo que, tan pronto como 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
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRepairApp
Use este parámetro para configurar la opción de la aplicación de reparación al crear una implementación para una aplicación.
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApprovalRequired
Si establece este parámetro en $true
, un administrador debe aprobar una solicitud para esta aplicación en el dispositivo.
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCloseExecutable
A partir de la versión 2107, establezca este parámetro para habilitar la configuración de implementación $true
de aplicaciones para comportamientos de instalación. A continuación, use el cmdlet Add-CMDeploymentTypeInstallBehavior para agregar un archivo ejecutable para comprobar que la instalación no se ejecuta correctamente.
Establezca este parámetro para $false
deshabilitar esta opción en las siguientes situaciones:
- Cuando se usa el cmdlet Remove-CMDeploymentTypeInstallBehavior para quitar todos los archivos ejecutables
- No desea que la implementación compruebe si hay ejecutables en ejecución.
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifique un objeto de colección en el que se implemente la aplicación. Para obtener este objeto, use el cmdlet Get-CMCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique el identificador de la colección en la que se implementa esta aplicación. Por ejemplo, "SMS00004"
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique el nombre de la colección en la que se implementa esta aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
Especifique un comentario opcional para esta implementación.
Type: | String |
Position: | Named |
Default value: | None |
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 |
Aliases: | SupersedenceDeadlineDateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DeployActionType |
Accepted values: | Install, Uninstall |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 que establezcas. 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.
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableContentDependencyDetection
Agregue este parámetro para no distribuir automáticamente contenido para aplicaciones dependientes.
Type: | SwitchParameter |
Aliases: | DisableDetectAssociatedContentDependencies |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeCollectionName
El sitio distribuye contenido a los puntos de distribución asociados con este nombre de colección.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeContent
Agregue este parámetro si primero necesita distribuir el contenido de la aplicación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
Para distribuir el contenido de la aplicación, especifique el nombre de un grupo de puntos de distribución.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
Para distribuir el contenido de la aplicación, especifique el nombre de un punto de distribución.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
Establezca este parámetro para habilitar el System Center de mantenimiento $true
de Operations Manager para esta implementación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
Establezca este parámetro para $true
habilitar la aplicación retrasada.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailParameterValue
Especifica el porcentaje de instalación de la aplicación con errores que provoca una alerta.
Especifique un número entero entre 1 y 100.
Para habilitar esta alerta, establezca el parámetro CreatAlertBaseOnPercentFailure en $True
.
Type: | Int32 |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateScomAlertOnFailure
Indica si se va a crear una alerta de Operations Manager si un cliente no puede instalar la aplicación.
Type: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifique el identificador de la aplicación que se implementará.
Type: | Int32 |
Aliases: | CIId, CI_ID, ApplicationId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique un objeto de aplicación que se implementará. Para obtener este objeto, use el cmdlet Get-CMApplication.
Type: | IResultObject |
Aliases: | Application |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifique el nombre de la aplicación que se implementará.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OverrideServiceWindow
Indica si la implementación se lleva a cabo incluso si se programa 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 , Configuration Manager implementa la aplicación incluso si la $True
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 pueda implementar en una ventana disponible.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indica si se habilitarán 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostponeDateTime
Cuando establezca CreateAlertBaseOnPercentSuccess en $true
, 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 |
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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplaceToastNotificationWithDialog
Cuando el software necesario esté disponible en el cliente, establezca este parámetro para reemplazar las notificaciones del sistema $true
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica si se debe enviar un paquete de activación a los equipos antes de que comience la implementación.
Si este valor es $True
, Configuration Manager intenta activar un equipo de suspensión.
Si este valor es , no reactiva $False
los equipos del estado de suspensión.
Para que los equipos se activen, primero debe configurar Wake on LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Simulation
Agregue este parámetro para crear una simulación de implementación. Para obtener más información, vea Simulate application deployments with Configuration Manager.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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 número entero entre 0 y 99.
Para habilitar esta alerta, establezca el parámetro CreateAlertBaseOnPercentSuccess como $True
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
Especifica qué zona horaria usar:
LocalTime
: Use la hora local.UTC
: Use la hora universal coordinada (UTC).
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 tan pronto como sea posible después de AvailableDateTime.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica si se permite que los clientes descarguen contenido a través de una conexión a Internet con contador después de la fecha límite, lo que puede incurrir en gastos adicionales.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object