New-SCServicingWindow

Moduł:

VirtualMachineManager

Tworzy przedział czasu obsługi i harmonogram dla przedziału czasu obsługi.

Składnia

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

Opis

Polecenie cmdlet New-SCServicingWindow tworzy okno obsługi i harmonogram przedziału czasu obsługi. Przedział czasu obsługi to zaplanowany przedział czasu, w którym można wykonać prace konserwacyjne na maszynie wirtualnej, hoście lub usłudze.

Przykłady

Przykład 1. Planowanie dziennego przedziału czasu obsługi

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

Pierwsze polecenie pobiera bieżącą datę i dodaje dwa dni, a następnie zapisuje wynik w zmiennej $Date.

Drugie polecenie tworzy okno obsługi o nazwie Backup Staging A, które odbywa się co trzeci dzień o godzinie 13:30 w strefie czasowej GMT (standardowa). Data rozpoczęcia okna obsługi jest ustawiona na datę przechowywaną w $Date, czyli w ciągu dwóch dni.

Przykład 2: Planowanie okna obsługi, które występuje jeden dzień w tygodniu

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

Pierwsze polecenie pobiera bieżącą datę i dodaje siedem dni (jeden tydzień), a następnie zapisuje wynik w zmiennej $Date.

Drugie polecenie tworzy okno obsługi o nazwie Test Servers Group 3, który występuje co tydzień w sobotę od 11:00 w wschodniej strefie czasowej i trwa 3 godziny (180 minut). Data rozpoczęcia okna obsługi jest ustawiona na datę przechowywaną w $Date, która przypada w ciągu siedmiu dni (jeden tydzień).

Przykład 3. Planowanie dwutygowego okna usługi

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

To polecenie tworzy okno obsługi o nazwie Staging Group C, które występuje co drugi tydzień (dwutygodnie) w sobotę i niedzielę począwszy od 10:30 pm w wschodniej strefie czasowej. Ponieważ nie określono daty rozpoczęcia, domyślnie okno obsługi staje się obowiązujące dzisiaj.

Przykład 4. Planowanie dwumiesięgowego przedziału czasu obsługi

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

To polecenie tworzy okno obsługi o nazwie Serwery produkcyjne A, które występuje co drugi miesiąc (dwumiesięczny) w drugi wtorek miesiąca, począwszy od 11:30 pm w wschodniej strefie czasowej. Ponieważ nie określono daty rozpoczęcia, domyślnie okno obsługi staje się obowiązujące dzisiaj.

Parametry

-Category

Określa kategorię przedziału czasu obsługi.

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

-DayOfMonth

Określa dzień porządkowy miesiąca, w którym rozpoczyna się harmonogram. Na przykład wartość 4 wskazuje czwarty dzień miesiąca. Ostatni wskazuje ostatni dzień miesiąca.

Wartość domyślna to liczba całkowita odpowiadająca dzieńowi określonemu w parametrze StartDate .

• Prawidłowe wartości całkowite: 1 – 31
• Prawidłowe wartości ciągów: 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

Określa ilość czasu w dniach między zaplanowanymi zadaniami. Wartość domyślna to minimalna wartość jednej (1). Wartość maksymalna to 999.

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

-Description

Określa opis okna obsługi.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-MinutesDuration

Określa okres w minutach. Użyj tego parametru, aby określić czas, przez który serwer lub usługę mają być umieszczane w trybie konserwacji.

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

-MonthlyScheduleDayOfWeek

Określa dzień tygodnia, aby uruchomić zadanie wykonywane zgodnie z harmonogramem miesięcznym. Można określić tylko jeden dzień tygodnia. Wartość domyślna to bieżący dzień (jeśli dzisiaj jest wtorek, wtorek jest wartością domyślną). Dopuszczalne wartości dla tego parametru to:

• Monday
• Tuesday
• Środa
• Thursday
• Piątek
• Sobota
• Niedziela

Wymaganie: użyj parametru 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

Określa ilość czasu w miesiącach między zaplanowanymi oknami usług. Wartość domyślna to minimalna wartość 1. Nie istnieje wartość maksymalna.

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

-Name

Określa nazwę obiektu programu Virtual Machine Manager (VMM).

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

-Owner

Określa właściciela obiektu programu VMM w postaci prawidłowego konta użytkownika domeny.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-StartDate

Określa datę uruchomienia okna usługi. Wartość domyślna to bieżąca data. Możesz wpisać nową datę w formacie daty krótkiej dla ustawień regionalnych lub przekazać obiekt DateTime z polecenia Get-Date.

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

-StartTimeOfDay

Określa godzinę dnia lub przedział czasu w okresie 24-godzinnym, aby uruchomić zadanie lub inną operację. Wartość domyślna to bieżący czas.

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

-TimeZone

Określa liczbę (indeks), która identyfikuje region geograficzny, który współudzieli ten sam czas standardowy. Aby uzyskać listę indeksów strefy czasowej, zobacz Wartości indeksu strefy czasowej firmy Microsoft pod adresem http://go.microsoft.com/fwlink/?LinkId=120935. Jeśli strefa czasowa nie zostanie określona, domyślna strefa czasowa używana dla maszyny wirtualnej jest tym samym ustawieniem strefy czasowej, które znajduje się na hoście maszyny wirtualnej.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

-WeeklyScheduleDayOfWeek

Określa co najmniej jeden dzień tygodnia, aby uruchomić zadanie. Wartość domyślna to bieżący dzień tygodnia.

• Prawidłowe wartości określające pojedynczy dzień przy użyciu ciągu: poniedziałek, wtorek, środa, czwartek, piątek, sobota, niedziela.
• Prawidłowe wartości określające zestaw dni w tygodniu: dowolny zestaw dwóch lub więcej dni rozdzielonych przecinkami.
• Prawidłowe wartości określające pojedynczy dzień przy użyciu liczby całkowitej: 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

Określa tydzień względem pierwszego dnia miesiąca, takiego jak pierwszy, drugi, trzeci, czwarty lub ostatni.

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

Określa ilość czasu w tygodniach między zaplanowanymi zadaniami. Wartość domyślna to minimalna wartość jednej (1). Nie istnieje wartość maksymalna.

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

Dane wyjściowe

ServicingWindow

To polecenie cmdlet zwraca obiekt ServicingWindow .

Linki powiązane

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