Compartir a través de

New-CMApplicationGroupDeployment

  • Referencia
Módulo:
ConfigurationManager

Cree una implementación para un grupo de aplicaciones.

Sintaxis

New-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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

Cree una implementación para un grupo de aplicaciones. Un grupo de aplicaciones contiene varias aplicaciones y los usuarios ven el grupo en el Centro de software como una sola entidad. Para obtener más información, consulte Creación de grupos de aplicaciones.

Para poder implementar un grupo de aplicaciones, debe crearlo. A continuación, puede implementarlo en un usuario o una recopilación de dispositivos como una única implementación.

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

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent

Parámetros

-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 como destino para esta implementación de grupo de aplicaciones. 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 un identificador de colección como destino para esta implementación de grupo de aplicaciones.

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

-CollectionName

Especifique un nombre de colección como destino para esta implementación de grupo de aplicaciones.

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 la implementación del grupo de aplicaciones.

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 si esta implementación va a instalar o desinstalar el grupo de aplicaciones.

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 si esta implementación está disponible para que los usuarios lo instalen o si es necesario instalarla en 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

-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 grupos de 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 para distribuir el contenido del grupo de aplicaciones al crear esta implementación. Los clientes no pueden instalar las aplicaciones hasta que distribuya contenido en puntos de distribución a los que los clientes puedan acceder.

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

-DistributionPointGroupName

El sitio distribuye contenido a este 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

El sitio distribuye contenido a este 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

-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

Establezca este parámetro $true en para generar una alerta de System Center Operations Manager cuando se produzca un error en la implementació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 del grupo de aplicaciones que se va a implementar.

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

-InputObject

Especifique un objeto para el grupo de aplicaciones. Para obtener este objeto, use el cmdlet Get-CMApplicationGroup .

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

-Name

Especifique un nombre para esta implementación de grupo de aplicaciones.

Tipo:String
Alias:LocalizedDisplayName, ApplicationGroupName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OverrideServiceWindow

Establezca este parámetro $true en para instalar el grupo de aplicaciones 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

-PersistOnWriteFilterDevice

Use este parámetro para controlar los filtros de escritura para dispositivos Windows Embedded. Si lo $trueestablece en , el dispositivo confirma los cambios en la fecha límite o durante una ventana de mantenimiento. Esta acción requiere un reinicio. Si lo $falseestablece en , el dispositivo guarda los cambios en la superposición temporal 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

-RebootOutsideServiceWindow

Establezca este parámetro $true en para permitir que el dispositivo se reinicie 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

-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 reactiva un equipo de suspensión. Si este valor es $False, no reactiva los equipos de suspensión. Para que los equipos se activen, configure primero Wake On LAN.

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

-TimeBaseOn

Especifique qué zona horaria se va a usar:

  • LocalTime: use la hora local del dispositivo.
  • 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 que los clientes de una conexión a Internet de uso medido descarguen contenido después de la fecha límite de instalación, lo que podría suponer costos adicionales.

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

-UserNotification

Use este parámetro para especificar la experiencia del usuario para esta implementación:

  • 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

IResultObject

Notas

Este cmdlet devuelve el SMS_ApplicationGroupAssignment objeto de clase WMI.