Start-CMSoftwareUpdateDeployment

  • Referencia
Módulo:
ConfigurationManager

(En desuso) Inicia una implementación de actualización de software en Configuration Manager.

Syntax

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     -InputObject <IResultObject>
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

Este cmdlet está en desuso. En su lugar, use New-CMSoftwareUpdateDeployment .

El cmdlet Start-CMSoftwareUpdateDeployment inicia una implementación de actualización de software.

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: Iniciar una implementación necesaria por nombre de actualización de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test" -Description "Contoso-test-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia una implementación de actualización de software necesaria mediante un nombre de actualización de software.

Ejemplo 2: Inicio de una implementación disponible por nombre de actualización de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test2" -Description "Contoso-test2-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia una implementación de actualización de software disponible mediante un nombre de actualización de software.

Ejemplo 3: Inicio de una implementación necesaria por nombre de grupo de actualizaciones de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test3" -Description "Contoso-test3-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia una implementación de actualización de software mediante un nombre de colección y un objeto de entrada.

Ejemplo 4: Inicio de una implementación por nombre de grupo de actualización de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test4" -Description "Contoso-test4-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia una implementación de actualización de software mediante un nombre de grupo de actualizaciones de software.

Parámetros

-AcceptEula

Algunas actualizaciones de software incluyen términos de licencia. Al implementar actualizaciones de software, no se muestran los términos de licencia. Agregue este parámetro para implementar automáticamente todas las actualizaciones de software independientemente de un término de licencia asociado.

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

-AllowRestart

Indica si se va a permitir un reinicio después de la instalación.

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

-AllowUseMeteredNetwork

Indica si se va a permitir que los clientes usen una red de uso medido para descargar actualizaciones.

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

-CollectionName

Especifica un nombre de una colección en Configuration Manager. Una colección es un grupo de equipos cliente.

Type:String
Position:Named
Default value:None
Required:True
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

-DeploymentAvailableDay

Especifica un día, en formato MM/DD/AAAA, cuando hay disponible una implementación de actualización de software. De forma predeterminada, la actualización está disponible inmediatamente.

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

-DeploymentAvailableTime

Especifica una hora, en formato HH:MM, cuando está disponible una implementación de actualización de software. De forma predeterminada, la actualización está disponible inmediatamente.

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

-DeploymentName

Especifica un nombre para una implementación de actualización de software en Configuration Manager.

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

-DeploymentType

Especifica un tipo de implementación en Configuration Manager.

Type:DeploymentType
Accepted values:Required, Available
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica una descripción para una implementación de actualización de software.

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

-DisableOperationsManagerAlert

Indica si se deshabilitan las alertas de System Center 2012 - Operations Manager durante las actualizaciones de software.

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

-DownloadFromMicrosoftUpdate

Indica si los clientes descargan actualizaciones directamente desde Microsoft Update.

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

-EnforcementDeadline

Type:DateTime
Aliases:DeploymentExpireTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnforcementDeadlineDay

Type:DateTime
Aliases:DeploymentExpireDay
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 una instalación de software.

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

-GenerateSuccessAlert

Indica si se generan alertas cuando una instalación de software se realiza correctamente.

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

-InputObject

Type:IResultObject
Aliases:SoftwareUpdate, SoftwareUpdateGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PercentSuccess

Especifica un porcentaje correcto.

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

-PersistOnWriteFilterDevice

Indica si se va a instalar una actualización de software en la superposición temporal y confirmar los cambios más adelante, o si se confirman los cambios en una fecha límite de instalación o una ventana de mantenimiento.

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

-ProtectedType

Especifica un tipo protegido.

Type:ProtectedType
Accepted values:NoInstall, RemoteDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartServer

Indica si se va a permitir que un servidor se reinicie después de una actualización de software. Establecer este valor en $True impide que el servidor se reinicie. Establecer este valor en $False permite que el servidor se reinicie.

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

-RestartWorkstation

Indica si se va a permitir que una estación de trabajo se reinicie después de una actualización de software. Establecer este valor en $True impide que el equipo se reinicie. Establecer este valor en $False permite que el equipo se reinicie.

Type:Boolean
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 se $True, Configuration Manager reactiva un equipo de suspensión. Si este valor está $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

-SoftwareInstallation

Indica si se va a permitir la instalación de la actualización de software, incluso si la instalación se produce fuera de una ventana de mantenimiento.

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

-SoftwareUpdateGroupId

Especifica un identificador para un grupo de actualizaciones de software. Un grupo de actualizaciones de software contiene actualizaciones de software individuales.

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

-SoftwareUpdateGroupName

Especifica un nombre para un grupo de actualizaciones de software.

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

-SoftwareUpdateId

Especifica un identificador para una actualización de software en Configuration Manager.

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

-SoftwareUpdateName

Especifica un nombre para una actualización de software en Configuration Manager.

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

-TimeBasedOn

Especifica que los equipos cliente usan la hora local o UTC para determinar la disponibilidad de un programa. La hora UTC hace que la actualización de software esté disponible al mismo tiempo para todos los equipos.

Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeUnit

Especifica la unidad de tiempo en Configuration Manager. Los valores admitidos son:

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

-TimeValue

Especifica un valor de hora en las unidades especificadas en el parámetro TimeUnit .

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

-UnprotectedType

Especifica un tipo sin protección.

Type:UnprotectedType
Accepted values:NoInstall, UnprotectedDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

Indica si se debe usar la caché de ramas como punto de distribución para las actualizaciones.

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

-UserNotification

Especifica un tipo de notificación de usuario.

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

-VerbosityLevel

Especifica el nivel de detalle. Los valores admitidos son:

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

System.Object