New-SCServicingWindow

Módulo:

VirtualMachineManager

Crea una ventana de mantenimiento y la programación de la ventana de mantenimiento.

Syntax

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -WeeklyScheduleDayOfWeek <String>
   [-WeeksToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -MonthlyScheduleDayOfWeek <DayOfWeek>
   -WeekOfMonth <WeekOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DayOfMonth <DayOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DaysToRecur <Int32>
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet New-SCServicingWindow crea una ventana de mantenimiento y la programación de la ventana de mantenimiento. Una ventana de mantenimiento es un período de tiempo programado durante el cual se puede realizar el trabajo de mantenimiento en una máquina virtual, un host o un servicio.

Ejemplos

Ejemplo 1: Programar una ventana de mantenimiento diario

PS C:\> $Date = (Get-Date).AddDays(2)
PS C:\> New-SCServicingWindow -Name "Backup Staging A" -Category "Non Essential" -StartDate $Date -StartTimeOfDay "13:30" -TimeZone 085 -DaysToRecur 3

El primer comando obtiene la fecha actual y agrega dos días y, a continuación, almacena el resultado en la variable $Date.

El segundo comando crea una ventana de mantenimiento denominada Backup Staging A que se produce cada tercer día a las 1:30 p. m. en la zona horaria ESTÁNDAR GMT. La fecha de inicio de la ventana de mantenimiento se establece en la fecha almacenada en $Date, que es en dos días.

Ejemplo 2: Programar una ventana de mantenimiento que se produce un día a la semana

PS C:\> $Date = (Get-Date).AddDays(7)
PS C:\> New-SCServicingWindow -Name "Test Servers Group 3" -Category "Test Group" -StartDate $Date -StartTimeOfDay "11:00" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday" -WeeksToRecur 1 -MinutesDuration 180

El primer comando obtiene la fecha actual y agrega siete días (una semana) y, a continuación, almacena el resultado en la variable $Date.

El segundo comando crea una ventana de mantenimiento denominada Grupo de servidores de prueba 3 que se produce semanalmente el sábado a partir de las 11:00 a. m. en la zona horaria oriental y dura 3 horas (180 minutos). La fecha de inicio de la ventana de mantenimiento se establece en la fecha almacenada en $Date, que se encuentra en siete días (una semana).

Ejemplo 3: Programar una ventana de servicio biweekly

PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2

Este comando crea una ventana de mantenimiento denominada Grupo de almacenamiento provisional C que se produce cada semana (biweekly) el sábado y domingo a partir de las 10:30 p. m. en la zona horaria oriental. Dado que no se especifica ninguna fecha de inicio, de forma predeterminada, la ventana de mantenimiento se hace efectiva hoy.

Ejemplo 4: Programar una ventana de mantenimiento bimontral

PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2

Este comando crea una ventana de mantenimiento denominada Servidores de producción A que se produce cada mes (bimonly) el segundo martes del mes, a partir de las 11:30 p. m. en la zona horaria oriental. Dado que no se especifica ninguna fecha de inicio, de forma predeterminada, la ventana de mantenimiento se hace efectiva hoy.

Parámetros

-Category

Especifica una categoría para una ventana de mantenimiento.

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

-DayOfMonth

Especifica el día ordinal del mes en el que se inicia la programación. Por ejemplo, 4 indica el cuarto día del mes. Last indica el último día del mes.

El valor predeterminado es el entero que corresponde al mismo día que se especifica en el parámetro StartDate .

• Valores enteros válidos: 1 - 31
• Valores de cadena válidos: First, Last

Type:	DayOfMonthType
Accepted values:	First, DayTwo, DayThree, DayFour, DayFive, DaySix, DaySeven, DayEight, DayNine, DayTen, DayEleven, DayTweleve, DayThirteen, DayFourteen, DayFifteen, DaySixteen, DaySeventeen, DayEighteen, DayNineteen, DayTwenty, DayTwentyOne, DayTwentyTwo, DayTwentyThree, DayTwentyFour, DayTwentyFive, DayTwentySix, DayTwentySeven, DayTwentyEight, DayTwentyNine, DayThirty, DayThirtyOne, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysToRecur

Especifica la cantidad de tiempo, en días, entre los trabajos programados. El valor predeterminado es el valor mínimo de uno (1). El valor máximo es 999.

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

-Description

Especifica una descripción para la ventana de mantenimiento.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-MinutesDuration

Especifica un período de tiempo en minutos. Use este parámetro para especificar la cantidad de tiempo durante el que se va a poner un servidor o servicio en modo de mantenimiento.

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

-MonthlyScheduleDayOfWeek

Especifica el día de la semana para ejecutar un trabajo que se produce según una programación mensual. Solo puede especificar un día de la semana. El valor predeterminado es el día actual (si hoy es martes, martes es el valor predeterminado). Los valores permitidos para este parámetro son los siguientes:

• Lunes
• Martes
• Miércoles
• Jueves
• Viernes
• Sábado
• Domingo

Requisito: use con el parámetro WeekOfMonth .

Type:	DayOfWeek
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthsToRecur

Especifica la cantidad de tiempo, en meses, entre ventanas de servicio programadas. El valor predeterminado es el valor mínimo de 1. No hay valor máximo.

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

-Name

Especifica el nombre de un objeto de Virtual Machine Manager (VMM).

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

-Owner

Especifica el propietario de un objeto de VMM en forma de cuenta de usuario de dominio válida.

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

-PROTipID

Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

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

-StartDate

Especifica la fecha de inicio de una ventana de servicio. El valor predeterminado es la fecha actual. Puede escribir una nueva fecha en el formato de fecha corta para la configuración regional, o bien, puede pasar un objeto DateTime desde Get-Date.

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

-StartTimeOfDay

Especifica la hora del día, o un intervalo de tiempo durante un período de 24 horas, para iniciar un trabajo u otra operación. El valor predeterminado es la hora actual.

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

-TimeZone

Especifica un número (un índice) que identifica una región geográfica que comparte la misma hora estándar. Para obtener una lista de índices de zona horaria, vea Valores de índice de zona horaria de Microsoft en .http://go.microsoft.com/fwlink/?LinkId=120935 Si no se especifica ninguna zona horaria, la zona horaria predeterminada usada para una máquina virtual es la misma configuración de zona horaria que se encuentra en el host de máquina virtual.

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

-VMMServer

Especifica un objeto de servidor VMM.

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

-WeeklyScheduleDayOfWeek

Especifica uno o varios días de la semana para ejecutar un trabajo. El valor predeterminado es el día actual de la semana.

• Valores válidos para especificar un día individual mediante una cadena: lunes, martes, miércoles, jueves, viernes, sábado, domingo.
• Valores válidos para especificar un conjunto de días en una semana: cualquier conjunto de dos o más días separados por comas.
• Valores válidos para especificar un día individual mediante un entero: 1, 2, 3, 4, 5, 6, 7

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

-WeekOfMonth

Especifica una semana relativa al primer día del mes, como primero, segundo, tercero, cuarto o último.

Type:	WeekOfMonthType
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WeeksToRecur

Especifica la cantidad de tiempo, en semanas, entre los trabajos programados. El valor predeterminado es el valor mínimo de uno (1). No hay valor máximo.

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

Salidas

ServicingWindow

Este cmdlet devuelve un objeto ServicingWindow .

Vínculos relacionados

• Get-SCServicingWindow
• Remove-SCServicingWindow
• Set-SCServicingWindow