New-SCServicingWindow

Модуль:

VirtualMachineManager

Создает окно обслуживания и расписание для периода обслуживания.

Синтаксис

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>]

Описание

Командлет New-SCServicingWindow создает окно обслуживания и расписание периода обслуживания. Период обслуживания — это запланированный период времени, в течение которого можно выполнить обслуживание на виртуальной машине, узле или службе.

Примеры

Пример 1. Планирование ежедневного периода обслуживания

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

Первая команда получает текущую дату и добавляет два дня, а затем сохраняет результат в переменной $Date.

Вторая команда создает окно обслуживания с именем Backup Staging A, которое происходит каждые третий день в 1:30 в часовом поясе GMT Standard. Дата начала периода обслуживания задается на дату, хранящуюся в $Date, которая находится в течение двух дней.

Пример 2. Планирование периода обслуживания, которое происходит один день в неделю

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

Первая команда получает текущую дату и добавляет семь дней (одну неделю), а затем сохраняет результат в переменной $Date.

Вторая команда создает окно обслуживания с именем Test Servers Group 3, которое происходит еженедельно в субботу, начиная с 11:00 в восточном часовом поясе и длится в течение 3 часов (180 минут). Дата начала периода обслуживания устанавливается на дату, хранящуюся в $Date, которая составляет семь дней (одна неделя).

Пример 3. Планирование двухнедельного окна службы

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

Эта команда создает окно обслуживания с именем Staging Group C, которое происходит каждые две недели (двунедельно) в субботу и воскресенье, начиная с 10:30 в восточном часовом поясе. Поскольку дата начала не указана, по умолчанию окно обслуживания становится действующим сегодня.

Пример 4. Планирование временного периода обслуживания

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

Эта команда создает окно обслуживания с именем Production Servers A, которое происходит каждые два месяца (в два месяца) во второй вторник месяца, начиная с 11:30 в восточном часовом поясе. Поскольку дата начала не указана, по умолчанию окно обслуживания становится действующим сегодня.

Параметры

-Category

Задает категорию для периода обслуживания.

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

-DayOfMonth

Указывает порядковый номер месяца, с которого начинается расписание. Например, 4 указывает четвертый день месяца. Последний день месяца.

Значение по умолчанию — целое число, соответствующее тому же дню, что и в параметре StartDate .

• Допустимые целые значения: 1 –31
• Допустимые строковые значения: 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

Указывает время в днях между запланированными заданиями. Значение по умолчанию — минимальное значение одного (1). Максимальное значение равно 999.

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

-Description

Задает описание окна обслуживания.

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

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре.

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

-MinutesDuration

Указывает период времени в минутах. Используйте этот параметр, чтобы указать время, в течение которого сервер или служба будут помещены в режим обслуживания.

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

-MonthlyScheduleDayOfWeek

Указывает день недели для выполнения задания, выполняемого по ежемесячному расписанию. Можно указать только один день недели. Значение по умолчанию — текущий день (если сегодня — вторник, вторник — значение по умолчанию). Допустимые значения для этого параметра:

• Понедельник
• Вторник
• Среда
• Четверг
• Пятница
• Суббота
• Воскресенье

Требование. Использование с параметром 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

Указывает время в месяцах между запланированными окнами служб. Значение по умолчанию — минимальное значение 1. Максимальное значение отсутствует.

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

-Name

Указывает имя объекта Virtual Machine Manager (VMM).

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

-Owner

Указывает владельца объекта VMM в виде допустимой учетной записи пользователя домена.

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

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет выполнять аудит советов PRO.

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

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы элемент управления немедленно возвращал командную оболочку.

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

-StartDate

Указывает дату запуска окна службы. Значение по умолчанию равно текущей дате. Вы можете ввести новую дату в коротком формате даты для языкового стандарта или передать объект DateTime из Get-Date.

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

-StartTimeOfDay

Указывает время суток или интервал времени в течение 24-часового периода, чтобы запустить задание или другую операцию. Значение по умолчанию — текущее время.

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

-TimeZone

Указывает число (индекс), идентифицирующее географический регион, который использует одно и то же стандартное время. Список индексов часовых поясов см. в разделе "Значения индекса часового пояса Майкрософт " по адресу http://go.microsoft.com/fwlink/?LinkId=120935. Если часовой пояс не указан, часовой пояс по умолчанию, используемый для виртуальной машины, совпадает с параметром часового пояса, который находится на узле виртуальной машины.

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

-VMMServer

Указывает объект сервера VMM.

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

-WeeklyScheduleDayOfWeek

Указывает один или несколько дней недели для запуска задания. Значение по умолчанию — текущий день недели.

• Допустимые значения для указания отдельного дня с помощью строки: понедельник, вторник, среда, четверг, пятница, суббота, воскресенье.
• Допустимые значения для указания набора дней в неделю: любой набор из двух или более дней, разделенных запятыми.
• Допустимые значения для указания отдельного дня с помощью целого числа: 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

Указывает неделю относительно первого дня месяца, например первого, второго, третьего, четвертого или последнего.

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

Указывает время в неделях между запланированными заданиями. Значение по умолчанию — минимальное значение одного (1). Максимальное значение отсутствует.

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

Выходные данные

ServicingWindow

Этот командлет возвращает объект ServicingWindow .

Связанные ссылки

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