New-CMWindowsServicingPlan
Crea un plan de mantenimiento de Windows 10.
Syntax
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 Configuration Manager, por ejemploPS 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 $LangSelectEl 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 .
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AlertTimeUnit
Especifica una unidad de tiempo para el parámetro AlertTime . 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 |
-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
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 incurrir en gastos 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
Especifique cuándo están disponibles las actualizaciones de 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 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 .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Especifica el identificador de la colección de dispositivos de destino que se va a usar para el plan de mantenimiento.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Especifica el nombre de la colección de dispositivos de destino que se usará para el plan de mantenimiento.
| 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 |
-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 |
-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 .
| Type: | IResultObject |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentRing
Especifica el estado de preparación de Windows al que se debe aplicar el plan de mantenimiento. Los valores admitidos son:
- CB
- Release
- BusinessMainstream
- Cbb
- Ltsb
| Type: | DeploymentRing |
| Accepted values: | CB, Release, BusinessMainstream, Cbb, Ltsb |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica una descripción para el plan de mantenimiento.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableOperationManager
Indica si se deben deshabilitar las alertas de System Center Operations Manager durante las actualizaciones de software.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DownloadFromInternet
Indica si se van a descargar actualizaciones de software desde Internet.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Enable
Indica si el plan de mantenimiento está habilitado.
| Type: | Boolean |
| Aliases: | Enabled, EnableDeployment |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GenerateOperationManagerAlert
Indica si se deben generar alertas de Operations Manager durante una actualización de software.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GenerateSuccessAlert
Indica si se debe generar una alerta para una implementación correcta.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Language
Especifica una matriz de idiomas que se usan para filtrar las actualizaciones de software que se agregarán al plan de servicio.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Especifica una ubicación de red en la que se encuentran las actualizaciones descargadas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 del sitio Configuration Manager.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 descarga ni instala actualizaciones de software. Si especifica un valor de $False, la instalación continúa.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunType
Especifica el modo en el que se ejecuta una actualización. Los valores admitidos son:
- DoNotRunThisRuleAutomatically
- RunTheRuleAfterAnySoftwareUpdatePointSynchronization
- RunTheRuleOnSchedule
| Type: | RunType |
| Accepted values: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | IResultObject |
| 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 |
-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.
| 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 |
-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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Aliases: | UpdateDeploymentWaitDays |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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: | UserNotificationType |
| 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 el nivel de detalle que desea que los clientes informen de las implementaciones que crea esta regla. Los valores admitidos son:
- AllMessages
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
| 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
None
Salidas
System.Object
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de