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 durchgefü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, speichert dann das Ergebnis in der $Date Variablen.

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 sich in zwei Tagen befindet.

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 das Ergebnis dann in der $Date Variablen.

Der zweite Befehl erstellt ein Wartungsfenster namens "TestServer Group 3", 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 biweekly-Dienstfensters

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

Dieser Befehl erstellt ein Wartungsfenster namens "Staging Group C", das alle anderen Wochen (biweekly) am Samstag und Sonntag ab 10:30 Uhr in der Östlichen Zeitzone 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

Dieser Befehl erstellt ein Wartungsfenster namens Production Servers A, 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.

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

-DayOfMonth

Gibt den Ordnungstag des Monats an, an dem der Zeitplan beginnt. Beispielsweise gibt 4 den vierten Tag des Monats an. Zuletzt wird der letzte Tag des Monats angegeben.

Der Standardwert ist die ganze Zahl, die demselben Tag entspricht wie im StartDate-Parameter angegeben.

• Gültige ganzzahlige Werte: 1 - 31
• Gültige Zeichenfolgenwerte: 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

Gibt den Zeitraum in Tagen zwischen geplanten Aufträgen an. Der Standardwert ist der Mindestwert eines (1). Der Maximalwert beträgt 999.

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

-Description

Gibt eine Beschreibung für das Wartungsfenster an.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-MinutesDuration

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

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

-MonthlyScheduleDayOfWeek

Gibt den Wochentag an, um einen Auftrag auszuführen, der in einem monatlichen Zeitplan auftritt. Sie können nur einen Tag der Woche angeben. Der Standardwert ist der aktuelle Tag (wenn heute Dienstag, Dienstag ist der Standardwert). Zulässige Werte für diesen Parameter:

• Montag
• Dienstag
• Wednesday
• Thursday
• Freitag
• Samstag
• Sonntag

Anforderung: Verwenden Sie den Parameter "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

Gibt den Zeitraum in Monaten zwischen geplanten Dienstfenstern an. Der Standardwert ist der Mindestwert von 1. Es gibt keinen Höchstwert.

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

-Name

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

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

-Owner

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-RunAsynchronously

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 ein DateTime-Objekt von Get-Date übergeben.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-TimeZone

Gibt eine Zahl (einen Index) an, die eine geografische Region identifiziert, die dieselbe 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 ist, wird als Standardzeitzone für eine virtuelle Maschine die gleiche Zeitzoneneinstellung wie auf dem Host für virtuelle Maschinen verwendet.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 Reihe 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 ganzzahligen Zahl: 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

Gibt eine Woche relativ zum ersten Tag des Monats an, z. B. zum ersten, zweiten, dritten, vierten oder letzten.

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

Gibt die Zeit in Wochen zwischen geplanten Aufträgen an. Der Standardwert ist der Mindestwert eines (1). Es gibt keinen Höchstwert.

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

Ausgaben

ServicingWindow

Dieses Cmdlet gibt ein ServicingWindow-Objekt zurück.

Ähnliche Themen

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