New-SCServicingWindow

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

Синтаксис

WeeklyFrequency

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

MonthlyRelativeFrequency

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

MonthlyFrequency

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

DailyFrequency

New-SCServicingWindow
    [-Name] <String>
    -DaysToRecur <Int32>
    [-VMMServer <ServerConnection>]
    [-Description <String>]
    [-Category <String>]
    [-Owner <String>]
    [-TimeZone <Int32>]
    [-StartDate <DateTime>]
    [-StartTimeOfDay <DateTime>]
    [-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.

Вторая команда создает сервисное окно с именем Резервная промежуточная среда A, которое происходит каждый третий день в 13:30 по стандартному часовому поясу GMT. Дата начала сервисного окна устанавливается на дату, сохраненную в $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

Эта команда создает сервисное окно с именем «Промежуточная группа C», которое создается раз в две недели (раз в две недели) в субботу и воскресенье, начиная с 22:30 по восточному часовому поясу. Поскольку дата начала не указана, по умолчанию окно обслуживания вступает в силу сегодня.

Пример 4: Запланируйте период обслуживания раз в два месяца

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

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

Параметры

-Category

Указывает категорию для сервисного окна.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DayOfMonth

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

Значением по умолчанию является целое число, соответствующее тому же дню, который указан в параметре StartDate .

  • Допустимые целочисленные значения: 1 - 31
  • Допустимые строковые значения: Первый, Последний

Свойства параметра

Тип:DayOfMonthType
Default value:None
Допустимые значения: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
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

MonthlyFrequency
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DaysToRecur

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DailyFrequency
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MinutesDuration

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MonthlyScheduleDayOfWeek

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

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

Требование: Используйте с параметром WeekOfMonth .

Свойства параметра

Тип:DayOfWeek
Default value:None
Допустимые значения:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

MonthlyRelativeFrequency
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MonthsToRecur

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

MonthlyRelativeFrequency
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
MonthlyFrequency
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Указывает имя объекта диспетчера виртуальных машин (VMM).

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Owner

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartDate

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

Свойства параметра

Тип:DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartTimeOfDay

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

Свойства параметра

Тип:DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TimeZone

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

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

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WeeklyScheduleDayOfWeek

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

  • Допустимые значения для указания отдельного дня с помощью строки: понедельник, вторник, среда, четверг, пятница, суббота, воскресенье.
  • Допустимые значения для указания набора дней в неделе: любой набор из двух или более дней, разделенных запятыми.
  • Допустимые значения для указания отдельного дня с помощью целого числа: 1, 2, 3, 4, 5, 6, 7

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

WeeklyFrequency
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WeekOfMonth

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

Свойства параметра

Тип:WeekOfMonthType
Default value:None
Допустимые значения:First, Second, Third, Fourth, Last
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

MonthlyRelativeFrequency
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WeeksToRecur

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

WeeklyFrequency
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

ServicingWindow

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