New-SCServicingWindow

Módulo:

VirtualMachineManager

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

Sintaxis

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 GMT Estándar. La fecha de inicio de la ventana de mantenimiento se establece en la fecha almacenada en $Date, que se encuentra 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 am en la zona horaria del Este 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: Programación de 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 ensayo C que se produce cada otra semana (quincenal) el sábado y domingo a partir de las 10:30 p. m. en la zona horaria del este. Dado que no se especifica ninguna fecha de inicio, de forma predeterminada, la ventana de mantenimiento se hace efectiva hoy en día.

Ejemplo 4: Programar una ventana de mantenimiento bimonthly

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 otro mes (de forma bimestre) el segundo martes del mes, a partir de las 11:30 p. m. en la zona horaria del Este. Dado que no se especifica ninguna fecha de inicio, de forma predeterminada, la ventana de mantenimiento se hace efectiva hoy en día.

Parámetros

-Category

Especifica una categoría para una ventana de mantenimiento.

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

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

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

-Description

Especifica una descripción para la ventana de mantenimiento.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

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

-MinutesDuration

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

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

-MonthlyScheduleDayOfWeek

Especifica el día de la semana para ejecutar un trabajo que se produce en 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 aceptables para este parámetro son:

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

Requisito: use con el parámetro WeekOfMonth.

Tipo:	DayOfWeek
Valores aceptados:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MonthsToRecur

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

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

-Name

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

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

-Owner

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

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

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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, consulte de 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 que se usa para una máquina virtual es la misma configuración de zona horaria que se encuentra en el host de la máquina virtual.

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

-VMMServer

Especifica un objeto de servidor VMM.

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

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

-WeekOfMonth

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

Tipo:	WeekOfMonthType
Valores aceptados:	First, Second, Third, Fourth, Last
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 ningún valor máximo.

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

Salidas

ServicingWindow

Este cmdlet devuelve un objeto ServicingWindow.

Vínculos relacionados

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