New-SCServicingWindow

Modul:

VirtualMachineManager

Erstellt ein Wartungsfenster und den Zeitplan für das Wartungsfenster.

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

Beschreibung

Das cmdlet New-SCServicingWindow erstellt ein Wartungsfenster und den Zeitplan für das Wartungsfenster. Ein Wartungsfenster ist ein geplanter Zeitrahmen, in dem Wartungsarbeiten auf einem virtuellen Computer, einem Host oder einem Dienst ausgeführt werden können.

Beispiele

Beispiel 1: Planen eines täglichen Wartungsfensters

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

Der erste Befehl ruft das aktuelle Datum ab und fügt zwei Tage hinzu und speichert dann das Ergebnis in der variablen $Date.

Der zweite Befehl erstellt ein Wartungsfenster namens Backup Staging A, das jeden dritten Tag um 1:30 Uhr in der GMT Standard Zeitzone auftritt. Das Startdatum des Wartungsfensters wird auf das in $Date gespeicherte Datum festgelegt, das in zwei Tagen liegt.

Beispiel 2: Planen eines Wartungsfensters, das einen Tag pro Woche auftritt

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

Der erste Befehl ruft das aktuelle Datum ab und fügt sieben Tage (eine Woche) hinzu und speichert dann das Ergebnis in der $Date Variablen.

Mit dem zweiten Befehl wird ein Wartungsfenster namens "Test Servers Group 3" erstellt, das wöchentlich am Samstag ab 11:00 Uhr in der Östlichen Zeitzone stattfindet und 3 Stunden dauert (180 Minuten). Das Startdatum des Wartungsfensters wird auf das in $Date gespeicherte Datum festgelegt, das sich in sieben Tagen (eine Woche) befindet.

Beispiel 3: Planen eines zweiwochenigen Dienstfensters

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

Mit diesem Befehl wird ein Wartungsfenster namens Staging Group C erstellt, das alle anderen Wochen (zweiwochen) am Samstag und Sonntag ab 10:30 Uhr in der Zeitzone Ost auftritt. Da kein Startdatum angegeben ist, wird das Wartungsfenster heute standardmäßig wirksam.

Beispiel 4: Planen eines bimontalen Wartungsfensters

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

Mit diesem Befehl wird ein Wartungsfenster namens Production Servers A erstellt, das jeden anderen Monat (bimonthly) am zweiten Dienstag des Monats ab 11:30 Uhr in der Östlichen Zeitzone auftritt. Da kein Startdatum angegeben ist, wird das Wartungsfenster heute standardmäßig wirksam.

Parameter

-Category

Gibt eine Kategorie für ein Wartungsfenster an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DayOfMonth

Gibt den Ordinaltag des Monats an, an dem der Zeitplan beginnt. Beispielsweise gibt 4 den vierten Tag des Monats an. Zuletzt gibt den letzten Tag des Monats an.

Der Standardwert ist die ganze Zahl, die dem gleichen Tag entspricht wie im StartDate Parameter angegeben.

• Gültige ganzzahlige Werte: 1 - 31
• Gültige Zeichenfolgenwerte: First, Last

Typ:	DayOfMonthType
Zulässige Werte:	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
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DaysToRecur

Gibt die Zeitspanne zwischen geplanten Aufträgen in Tagen an. Der Standardwert ist der Mindestwert von 1 (1). Der Maximalwert ist 999.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

Gibt eine Beschreibung für das Wartungsfenster an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MinutesDuration

Gibt einen Zeitraum in Minuten an. Verwenden Sie diesen Parameter, um die Zeitspanne anzugeben, für die ein Server oder Dienst in den Wartungsmodus versetzt werden soll.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MonthlyScheduleDayOfWeek

Gibt den Wochentag an, an dem ein Auftrag ausgeführt werden soll, der monatlich ausgeführt wird. Sie können nur einen Tag der Woche angeben. Der Standardwert ist der aktuelle Tag (wenn heute Dienstag, Dienstag der Standardwert ist). Die zulässigen Werte für diesen Parameter sind:

• Montag
• Dienstag
• Mittwoch
• Donnerstag
• Freitag
• Samstag
• Sonntag

Anforderung: Wird mit dem parameter WeekOfMonth verwendet.

Typ:	DayOfWeek
Zulässige Werte:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MonthsToRecur

Gibt die Zeitspanne zwischen geplanten Dienstfenstern in Monaten an. Der Standardwert ist der Mindestwert von 1. Es gibt keinen Maximalwert.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Gibt den Namen eines VMM-Objekts (Virtual Machine Manager) an.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:	Guid
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StartDate

Gibt das Datum an, an dem ein Dienstfenster gestartet werden soll. Der Standardwert ist das aktuelle Datum. Sie können ein neues Datum im kurzen Datumsformat für Ihr Gebietsschema eingeben, oder Sie können ein DateTime--Objekt von Get-Dateübergeben.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StartTimeOfDay

Gibt die Tageszeit oder einen Zeitraum von 24 Stunden an, um einen Auftrag oder einen anderen Vorgang zu starten. Der Standardwert ist die aktuelle Uhrzeit.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TimeZone

Gibt eine Zahl (einen Index) an, die eine geografische Region identifiziert, die die gleiche Standardzeit hat. Eine Liste der Zeitzonenindizes finden Sie unter Microsoft Time Zone Index Values at http://go.microsoft.com/fwlink/?LinkId=120935. Wenn keine Zeitzone angegeben wird, ist die standardzeitzone, die für einen virtuellen Computer verwendet wird, dieselbe Zeitzoneneinstellung, die sich auf dem Host des virtuellen Computers befindet.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:	ServerConnection
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WeeklyScheduleDayOfWeek

Gibt einen oder mehrere Tage der Woche an, um einen Auftrag auszuführen. Der Standardwert ist der aktuelle Wochentag.

• Gültige Werte, um einen einzelnen Tag mithilfe einer Zeichenfolge anzugeben: Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag.
• Gültige Werte, um eine Gruppe von Tagen in einer Woche anzugeben: Jede Gruppe von zwei oder mehr Tagen, die durch Kommas getrennt sind.
• Gültige Werte zum Angeben eines einzelnen Tages mithilfe einer ganzen Zahl: 1, 2, 3, 4, 5, 6, 7

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WeekOfMonth

Gibt eine Woche relativ zum ersten Tag des Monats an, z. B. erster, zweiter, dritter, vierter oder letzter.

Typ:	WeekOfMonthType
Zulässige Werte:	First, Second, Third, Fourth, Last
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WeeksToRecur

Gibt die Zeitspanne zwischen geplanten Aufträgen in Wochen an. Der Standardwert ist der Mindestwert von 1 (1). Es gibt keinen Maximalwert.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Ausgaben

ServicingWindow

Dieses Cmdlet gibt ein ServicingWindow--Objekt zurück.

Ähnliche Themen

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