New-SCServicingWindow

Modul:

VirtualMachineManager

Vytvoří časové období údržby a plán časového období údržby.

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

Description

Rutina New-SCServicingWindow vytvoří časové období údržby a plán pro časové období údržby. Časové období údržby je naplánovaný časový rámec, během kterého je možné provádět práci údržby na virtuálním počítači, hostiteli nebo službě.

Příklady

Příklad 1: Naplánování denního časového období údržby

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

První příkaz získá aktuální datum a přidá dva dny a pak uloží výsledek do proměnné $Date.

Druhý příkaz vytvoří časové období obsluhy s názvem Backup Staging A, které se vyskytuje každý třetí den v 13:30 v časovém pásmu GMT Standard. Počáteční datum časového období údržby je nastavené na datum uložené v $Date, což je za dva dny.

Příklad 2: Naplánování časového období údržby, ke kterému dochází jeden den v týdnu

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

První příkaz získá aktuální datum a přidá sedm dnů (jeden týden) a uloží výsledek do proměnné $Date.

Druhý příkaz vytvoří časové období obsluhy s názvem Skupina testovacích serverů 3, ke kterému dochází v sobotu od 11:00 ve východním časovém pásmu a trvá 3 hodiny (180 minut). Počáteční datum časového období údržby je nastavené na datum uložené v $Date, které je v sedmi dnech (jeden týden).

Příklad 3: Naplánování okna služby s biweekly

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

Tento příkaz vytvoří časové období obsluhy s názvem Pracovní skupina C, ke které dochází každý druhý týden (v sobotu) a neděli od 10:30 ve východním časovém pásmu. Vzhledem k tomu, že není zadáno žádné počáteční datum, ve výchozím nastavení se servisní období stane efektivním dnes.

Příklad 4: Naplánování bimontového časového období údržby

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

Tento příkaz vytvoří časové období obsluhy s názvem Produkční servery A, které se vyskytuje každý druhý měsíc (bimontly) druhé úterý v měsíci počínaje 11:30 v východním časovém pásmu. Vzhledem k tomu, že není zadáno žádné počáteční datum, ve výchozím nastavení se servisní období stane efektivním dnes.

Parametry

-Category

Určuje kategorii pro časové období údržby.

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

-DayOfMonth

Určuje pořadový den v měsíci, na kterém začíná plán. Například 4 označuje čtvrtý den v měsíci. Poslední označuje poslední den v měsíci.

Výchozí hodnota je celé číslo, které odpovídá stejnému dni, jako je zadaný v parametru StartDate .

• Platné celočíselné hodnoty: 1 – 31
• Platné řetězcové hodnoty: První, Poslední

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

Určuje dobu mezi naplánovanou úlohou ve dnech. Výchozí hodnota je minimální hodnota jedné (1). Maximální hodnota je 999.

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

-Description

Určuje popis časového období údržby.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-MinutesDuration

Určuje časové období v minutách. Tento parametr použijte k určení doby, po kterou se má server nebo služba umístit do režimu údržby.

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

-MonthlyScheduleDayOfWeek

Určuje den v týdnu pro spuštění úlohy, ke které dochází v měsíčním plánu. Můžete zadat pouze jeden den v týdnu. Výchozí hodnota je aktuální den (pokud je dnes úterý, úterý je výchozí). Tento parametr přijímá tyto hodnoty:

• Monday
• Úterý
• Středa
• Čtvrtek
• Pátek
• Sobota
• Neděle

Požadavek: Použijte s parametrem 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

Určuje dobu mezi časovými intervaly naplánované služby v měsících. Výchozí hodnota je minimální hodnota 1. Neexistuje žádná maximální hodnota.

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

-Name

Určuje název objektu nástroje Virtual Machine Manager (VMM).

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

-Owner

Určuje vlastníka objektu VMM ve formátu platného uživatelského účtu domény.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

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

-StartDate

Určuje datum spuštění okna služby. Výchozí hodnota je aktuální datum. Nové datum můžete zadat v krátkém formátu data národního prostředí nebo můžete předat objekt DateTime z get-Date.

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

-StartTimeOfDay

Určuje denní dobu nebo časový rozsah během 24hodinového období pro spuštění úlohy nebo jiné operace. Výchozí hodnota je aktuální čas.

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

-TimeZone

Určuje číslo (index), které identifikuje geografickou oblast, která sdílí stejný standardní čas. Seznam indexů časových pásem naleznete v tématu Hodnoty indexu časových pásem společnosti Microsoft na adrese http://go.microsoft.com/fwlink/?LinkId=120935. Pokud není zadané žádné časové pásmo, výchozí časové pásmo použité pro virtuální počítač je stejné nastavení časového pásma, které je na hostiteli virtuálního počítače.

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

-VMMServer

Určuje objekt serveru VMM.

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

-WeeklyScheduleDayOfWeek

Určuje jeden nebo více dnů v týdnu ke spuštění úlohy. Výchozí hodnota je aktuální den v týdnu.

• Platné hodnoty pro zadání jednotlivého dne pomocí řetězce: pondělí, úterý, středa, čtvrtek, pátek, sobota, neděle.
• Platné hodnoty pro zadání sady dnů v týdnu: Libovolná sada dvou nebo více dnů oddělených čárkami.
• Platné hodnoty pro zadání jednotlivého dne pomocí celého čísla: 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

Určuje týden vzhledem k prvnímu dni v měsíci, například první, druhý, třetí, čtvrtý nebo poslední.

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

Určuje dobu mezi naplánovanou úlohou v týdnech. Výchozí hodnota je minimální hodnota jedné (1). Neexistuje žádná maximální hodnota.

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

Výstupy

ServicingWindow

Tato rutina vrátí objekt ServicingWindow .

Související odkazy

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