Set-CMAutoDeploymentRuleDeployment

  • Referencia
Módulo:
ConfigurationManager

Establece una implementación para una regla de implementación automática.

Syntax

Set-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-InputObject] <IResultObject>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-PassThru]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Id] <Int32>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-PassThru]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-CMAutoDeploymentRuleDeployment actualiza una implementación para una regla de implementación automática.

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: Establecer una implementación por identificador

PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False  -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer  $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False

Este comando actualiza la configuración de la implementación de la regla de implementación con el identificador de acción 348 y la colección denominada Todos los sistemas.

Ejemplo 2: Establecer una implementación mediante una variable

PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False

El primer comando obtiene el objeto de regla de implementación automática denominado TestADR01 y almacena el objeto en la variable $ReferenceADR.

El segundo comando obtiene las implementaciones asociadas al objeto de regla de implementación automática almacenado en $ReferenceADR y almacena las implementaciones en la variable $Deployment.

El último comando actualiza la configuración de la primera implementación almacenada en $Deployment.

Parámetros

-AlertTime

Especifica el número de unidades de tiempo para el desplazamiento desde la fecha límite.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlertTimeUnit

Especifica el tipo de unidad de tiempo para el desplazamiento de la fecha límite. Los valores admitidos son:

  • Horas
  • Días
  • Semanas
  • Meses
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowDownloadFromMicrosoftUpdate

Use este parámetro para establecer la siguiente opción en la página Configuración de descarga de la configuración de implementación de ADR: si las actualizaciones de software no están disponibles en el punto de distribución de los grupos de límites actuales, vecinos o de sitio, descargue el contenido de Microsoft Novedades.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowRestart

Indica si se permite realizar un reinicio del sistema fuera de las ventanas de mantenimiento definidas cuando se alcanza la fecha límite de instalación.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowSoftwareInstallationOutsideMaintenanceWindow

Indica si se permite la instalación de software fuera de las ventanas de mantenimiento definidas cuando se alcanza la fecha límite de instalación.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUseMeteredNetwork

Use este parámetro para establecer la siguiente opción en la página Configuración de descarga de la configuración de implementación de ADR: Permitir 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 incurrir en costos adicionales.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailableImmediately

Indica si las actualizaciones de software están disponibles para instalarse lo antes posible después de ejecutar la regla.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailableTime

Especifica el número de unidades de tiempo para el tiempo disponible del software.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailableTimeUnit

Especifica el tipo de unidad de tiempo para la hora disponible del software. Los valores admitidos son:

  • Horas
  • Días
  • Semanas
  • Meses
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Collection

Especifica un objeto de colección de destino para la implementación de actualizaciones de software. Para obtener un objeto de colección, use el cmdlet Get-CMCollection .

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

Especifica el identificador de la colección de destino para la implementación de actualizaciones de software.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifica el nombre de la colección de destino para la implementación de actualizaciones de software.

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

-DeadlineImmediately

Indica si las actualizaciones de software necesarias se instalan lo antes posible cuando se alcanza la fecha límite.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineTime

Especifica el número de unidades de tiempo para la fecha límite.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineTimeUnit

Especifica el tipo de unidad de tiempo para la fecha límite. Los valores admitidos son:

  • Horas
  • Días
  • Semanas
  • Meses
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableOperationsManager

Indica si las alertas de Operations Manager están deshabilitadas mientras se ejecutan las actualizaciones de software.

Type:Boolean
Aliases:DisableOperationManager
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

-EnableDeployment

Indica si se va a habilitar la implementación después de que se ejecute esta regla para el grupo de software asociado. Si se establece en $False, debe implementar manualmente el grupo de actualizaciones de software.

Type:Boolean
Aliases:Enable, EnabledAfterCreate, EnableAfterCreate
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

-GenerateOperationsManagerAlert

Indica si se generan alertas de Operations Manager cuando se produce un error en la instalación de una actualización de software.

Type:Boolean
Aliases:GenerateOperationManagerAlert
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GenerateSuccessAlert

Indica si se genera una alerta cuando esta regla se ejecuta correctamente.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica el identificador de acción de la implementación automática de la regla de implementación.

Type:Int32
Aliases:ActionID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica un objeto de regla de implementación automática. Para obtener un objeto de regla de implementación automática, use el cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

Type:IResultObject
Aliases:AutoDeploymentRuleDeployment
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoInstallOnRemote

Indica si se deben instalar actualizaciones de software cuando las actualizaciones no están disponibles en ningún punto de distribución remoto.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoInstallOnUnprotected

Indica si se deben instalar actualizaciones de software cuando las actualizaciones no están disponibles en puntos de distribución no protegidos.

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

-RequirePostRebootFullScan

Use este parámetro para establecer la siguiente opción en la página Experiencia del usuario de la configuración de implementación de ADR: Si alguna actualización de esta implementación requiere un reinicio del sistema, ejecute el ciclo de evaluación de la implementación de actualizaciones después del reinicio.

Type:Boolean
Aliases:RunEvaluationAfterRestart
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

Indica si se debe usar Wake-on-LAN para reactivar clientes para las implementaciones necesarias.

Type:Boolean
Aliases:EnableWakeOnLan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftDeadlineEnabled

Use este parámetro para establecer la siguiente opción en la página Programación de implementación de la configuración de implementación de ADR: Retrasar el cumplimiento de esta implementación según las preferencias del usuario, hasta el período de gracia definido en la configuración del cliente.

Type:Boolean
Aliases:DelayEnforcementAndUpToGracePeriod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SuccessPercentage

Especifica el porcentaje, como entero, del cumplimiento del cliente. Cuando el cumplimiento del cliente está por debajo de este porcentaje, se genera una alerta.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SuppressRestartServer

Indica si un reinicio del sistema se suprime en los servidores cuando una actualización de software requiere un reinicio del sistema para completar el proceso de instalación.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SuppressRestartWorkstation

Indica si un reinicio del sistema se suprime en las estaciones de trabajo cuando una actualización de software requiere un reinicio del sistema para completar el proceso de instalación.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

Indica si los clientes pueden compartir contenido con otros clientes de la misma subred.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserNotification

Especifica el comportamiento de notificación de la experiencia visual del usuario. Los valores admitidos son:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
Type:UserNotificationOption
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUtc

Indica si la programación de esta implementación se evalúa en función de la hora universal coordinada (UTC).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerboseLevel

Especifica la cantidad de detalles de estado que los clientes notifican para las implementaciones creadas por esta regla. Los valores admitidos son:

  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
  • AllMessages
Type:VerboseLevelType
Accepted values:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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

-WriteFilterHandling

Indica si los cambios se confirman en la fecha límite o durante una ventana de mantenimiento (requiere reinicios). Si se establece en $False, el contenido se aplica a la superposición y se confirma más adelante.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject