New-SCServicingWindow
建立服務視窗和服務視窗的排程。
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
New-SCServicingWindow Cmdlet 會建立服務視窗和服務視窗的排程。 服務時段是排程的時間範圍,可在虛擬機器、主機或服務上完成維護工作。
範例
範例 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變數中。
第二個命令會建立名為 Backup Staging A 的服務視窗,該時段會在 GMT 標準時區的下午 1:30 下午 1:30 發生。 服務視窗的開始日期會設定為儲存在 $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 中的日期,也就是 7 天 (一周) 。
範例 3:排程雙周服務視窗
PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2
此命令會建立名為暫存群組 C 的服務視窗,該時段會在星期六和星期日的 (星期六和星期日下午 10:30 開始每隔一周) 一次。 因為未指定開始日期,所以根據預設,服務視窗會立即生效。
範例 4:排程雙向服務視窗
PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2
此命令會建立名為「生產伺服器 A」的服務視窗,該視窗會在一個月的第二個星期二 (每星期二) 一次,從東部時區的下午 11:30 開始。 因為未指定開始日期,所以根據預設,服務視窗會立即生效。
參數
-Category
指定服務視窗的類別。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DayOfMonth
指定排程開始之月份的序數日。 例如,4 表示月份的第四天。 Last 表示月份的最後一天。
預設值是對應于 StartDate 參數中所指定日期的整數。
- 有效的整數值:1 - 31
- 有效的字串值: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
指定排程工作之間的時間量,以天為單位。 預設值是 1 (1) 的最小值。 最大值為 999。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定服務視窗的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
指定追蹤工作進度,並將工作進度存放在這個參數命名的變數中。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinutesDuration
以分鐘為單位指定一段時間。 使用此參數來指定將伺服器或服務放入維護模式的時間量。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MonthlyScheduleDayOfWeek
指定執行依每月排程發生的作業的星期幾。 您只能指定一周的一天。 如果今天是星期二,則預設值是目前日期 (,星期二是預設) 。 此參數可接受的值為:
- Monday
- Tuesday
- Wednesday
- Thursday
- 星期五
- 星期六
- 星期日
需求:搭配 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
指定排程服務時段之間的時間量,以月為單位。 預設值為最小值 1。 沒有最大值。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定 Virtual Machine Manager (VMM) 物件的名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Owner
以有效網域使用者帳戶的格式指定 VMM 物件的擁有者。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行,讓控制項立即返回命令殼層。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartDate
指定要啟動服務視窗的日期。 預設值是目前日期。 您可以使用地區設定的簡短日期格式輸入新日期,也可以從Get-Date傳遞DateTime物件。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartTimeOfDay
指定一天的時間,或 24 小時期間的時間範圍,以啟動作業或其他作業。 預設值為目前時間。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeZone
指定 (索引) 的數位,識別共用相同標準時間的地理區域。
如需時區索引的清單,請參閱 中的 http://go.microsoft.com/fwlink/?LinkId=120935
Microsoft 時區索引值。
如果未指定時區,則用於虛擬機器的預設時區是虛擬機器主機上的相同時區設定。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WeeklyScheduleDayOfWeek
指定要執行作業的一或多個星期幾。 預設值為當周的目前日期。
- 使用字串指定個別日期的有效值:星期一、星期二、星期三、星期四、星期五、星期六、星期日。
- 有效值可指定一周中的一組天數:以逗號分隔的兩或多天的任何一組。
- 使用整數指定個別日期的有效值: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
指定一周相對於月份的第一天,例如第一天、第二天、第三天、第四天或最後一天。
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
指定排程工作之間的時間量,以周為單位。 預設值是 1 (1) 的最小值。 沒有最大值。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸出
ServicingWindow
此 Cmdlet 會傳回 ServicingWindow 物件。