New-CMWindowsServicingPlan

Crea un plan de mantenimiento de Windows 10.

Sintaxis

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-CMWindowsServicingPlan crea un plan de mantenimiento de Windows 10.

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: Creación de un plan de mantenimiento por identificador de colección

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

El primer comando crea una lista de idiomas y almacena la lista en la variable $Lang.

El segundo comando crea una lista de cadenas de búsqueda y almacena la lista en la variable $Required. Esta cadena de búsqueda encontrará las actualizaciones de software necesarias en al menos un equipo y un máximo de 100 equipos.

El tercer comando crea una lista de títulos de actualización de software y almacena la lista en la variable $Title.

El último comando obtiene el paquete de implementación de actualización de software denominado SUDP01 y, a continuación, crea un plan de mantenimiento de Windows denominado Test para la colección de destino con el identificador MP40001A. El comando agrega los idiomas de filtro de actualización almacenados en $Lang, el filtro necesario almacenado en $Required y el filtro de título de actualización de software almacenado en $Title.

Ejemplo 2: Creación de un plan de mantenimiento por nombre de colección

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

El primer comando crea una lista de idiomas de selección de idioma y almacena la lista en la variable $LangSelect.

El segundo comando obtiene el paquete de implementación de actualización de software denominado SUP02 y, a continuación, crea un plan de mantenimiento de Windows denominado Test02 para la colección de destino denominada ColName02. El comando agrega los idiomas de selección de idioma almacenados en $LangSelect.

Parámetros

-AlertTime

Especifica un desplazamiento entero de una fecha límite de implementación de actualizaciones. La regla usa este valor para especificar cuándo genera alertas la regla. Especifique una unidad de tiempo mediante el parámetro AlertTimeUnit .

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

-AlertTimeUnit

Especifica una unidad de tiempo para el parámetro AlertTime . Los valores admitidos son:

  • Horas
  • Días
  • Semanas
  • Meses
Tipo:TimeUnitType
Valores aceptados:Hours, Days, Weeks, Months
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

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

-AllowUseMeteredNetwork

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

-AvailableImmediately

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

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

-AvailableTime

Especifique cuándo están disponibles las actualizaciones de software.

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

-AvailableTimeUnit

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

  • Horas
  • Días
  • Semanas
  • Meses
Tipo:TimeUnitType
Valores aceptados:Hours, Days, Weeks, Months
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Collection

Especifica el objeto de recopilación de dispositivos de destino que se usará para el plan de mantenimiento. Para obtener un objeto de colección de dispositivos, use los cmdlets Get-CMCollection o Get-CMDeviceCollection .

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

-CollectionId

Especifica el identificador de la colección de dispositivos de destino que se va a usar para el plan de mantenimiento.

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

-CollectionName

Especifica el nombre de la colección de dispositivos de destino que se usará para el plan de mantenimiento.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeadlineImmediately

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

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

-DeadlineTime

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

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

-DeadlineTimeUnit

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

  • Horas
  • Días
  • Semanas
  • Meses
Tipo:TimeUnitType
Valores aceptados:Hours, Days, Weeks, Months
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeploymentPackage

Especifica un paquete de implementación de actualizaciones de software. Para obtener un paquete de implementación de actualizaciones de software, use el cmdlet Get-CMSoftwareUpdateDeploymentPackage .

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

-DeploymentRing

Especifica el estado de preparación de Windows al que se debe aplicar el plan de mantenimiento. Los valores admitidos son:

  • CB
  • Versión
  • BusinessMainstream
  • Cbb
  • Ltsb
Tipo:DeploymentRing
Valores aceptados:CB, Release, BusinessMainstream, Cbb, Ltsb
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción para el plan de mantenimiento.

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

-DisableOperationManager

Indica si se deben deshabilitar las alertas de System Center Operations Manager durante las actualizaciones de software.

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

-DownloadFromInternet

Indica si se van a descargar actualizaciones de software desde Internet.

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

-DownloadFromMicrosoftUpdate

Indica si los equipos descargan contenido de Microsoft Update si las actualizaciones de software no están disponibles en un punto de distribución preferido o en un punto de distribución remoto.

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

-Enable

Indica si el plan de mantenimiento está habilitado.

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

-GenerateOperationManagerAlert

Indica si se deben generar alertas de Operations Manager durante una actualización de software.

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

-GenerateSuccessAlert

Indica si se debe generar una alerta para una implementación correcta.

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

-Language

Especifica una matriz de idiomas que se usan para filtrar las actualizaciones de software que se agregarán al plan de servicio.

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

-LanguageSelection

Especifica una matriz de idiomas, como cadenas. Los equipos descargan actualizaciones de software disponibles en los idiomas especificados, además de actualizaciones no específicas del idioma.

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

-Location

Especifica una ubicación de red en la que se encuentran las actualizaciones descargadas.

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

-Name

Especifica un nombre para el plan de mantenimiento. El nombre debe ser único, ayudar a describir el objetivo de la regla e identificarlo de otros usuarios en el sitio de Configuration Manager.

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

-NoInstallOnRemote

Indica si se va a permitir la instalación de actualizaciones en sistemas remotos. Si especifica un valor de $True, si el cliente está dentro de un límite de red lento o poco confiable, o cuando el cliente usa una ubicación de origen de reserva para el contenido, Configuration Manager no instala actualizaciones de software. Si especifica un valor de $False, la instalación continúa.

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

-NoInstallOnUnprotected

Indica si se va a permitir la instalación de actualizaciones en sistemas no protegidos. Si especifica un valor de $True, si las actualizaciones de software no están disponibles en ningún punto de distribución preferido, Configuration Manager no descargará ni instalará las actualizaciones de software. Si especifica un valor de $False, la instalación continúa.

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

-Required

Especifica una matriz de cadenas de búsqueda usadas para filtrar las actualizaciones de software que se agregarán al plan de servicio.

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

-RunType

Especifica el modo en el que se ejecuta una actualización. Los valores admitidos son:

  • DoNotRunThisRuleAutomatically
  • RunTheRuleAfterAnySoftwareUpdatePointSynchronization
  • RunTheRuleOnSchedule
Tipo:RunType
Valores aceptados:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Schedule

Especifica la hora límite (desde la hora disponible de la implementación). Para crear una programación, use el cmdlet New-CMSchedule .

Tipo:IResultObject
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 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.

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

-SuccessPercentage

Especifica un porcentaje para el cumplimiento del cliente como un entero de 0 a 99. Si el cumplimiento es inferior a este porcentaje, Configuration Manager genera alertas opcionales.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

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

-Title

Especifica una matriz de cadenas de búsqueda usadas para filtrar los títulos de actualización de software que se agregarán al plan de servicio.

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

-UpdateDeploymentWaitDay

Especifica el número de días que debe esperar después de que Microsoft haya publicado una nueva actualización antes de implementarla en su entorno.

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

-UseBranchCache

Indica si se va a usar una caché de rama. Si especifica un valor de $True, los clientes comparten contenido en la misma subred.

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

-UserNotification

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

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
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

-UseUtc

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

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

-VerboseLevel

Especifica el nivel de detalle que desea que los clientes informen de las implementaciones que crea esta regla. Los valores admitidos son:

  • AllMessages
  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
Tipo:VerboseLevelType
Valores aceptados:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

Entradas

None

Salidas

System.Object