New-SCServicingWindow
サービス期間とサービス期間のスケジュールを作成します。
構文
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>] 説明
New-SCServicingWindow コマンドレットは、サービス期間とサービス期間のスケジュールを作成します。 サービス期間は、仮想マシン、ホスト、またはサービスでメンテナンス作業を実行できるスケジュールされた期間です。
例
例 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最初のコマンドは現在の日付を取得し、2 日を加算した後、結果を $Date 変数に格納します。
2 番目のコマンドは、GMT 標準タイム ゾーンの午後 1 時 30 分に 3 日おきに発生する Backup Staging A というサービス ウィンドウを作成します。 サービス期間の開始日は、$Dateに格納されている日付 (2 日間) に設定されます。
例 2: 週に 1 日発生するサービス期間をスケジュールする
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最初のコマンドは現在の日付を取得し、7 日間 (1 週間) を加算し、結果を $Date 変数に格納します。
2 番目のコマンドでは、テスト サーバー グループ 3 という名前のサービス ウィンドウが作成されます。このウィンドウは、土曜日の午前 11 時から東部タイム ゾーンで毎週実行され、3 時間 (180 分) 続きます。 サービス期間の開始日は、$Dateに格納されている日付 (7 日間 (1 週間) に設定されます。
例 3: 隔週のサービス ウィンドウをスケジュールする
PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2このコマンドは、東部タイム ゾーンの午後 10 時 30 分から土曜日と日曜日に隔週 (隔週) に発生するステージング グループ C という名前のサービス ウィンドウを作成します。 開始日が指定されていないため、既定では、サービス期間は今日有効になります。
例 4: 隔月のサービス期間をスケジュールする
PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2このコマンドは、東部タイム ゾーンの午後 11 時 30 分から、月の第 2 火曜日に隔月 (隔月) に発生する運用サーバー A というサービス ウィンドウを作成します。 開始日が指定されていないため、既定では、サービス期間は今日有効になります。
パラメーター
-Category
サービス 期間のカテゴリを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DayOfMonth
スケジュールが開始される月の序数を指定します。 たとえば、4 は月の 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 の最小値です。 最大値は 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
月次スケジュールで発生するジョブを実行する曜日を指定します。 指定できる曜日は 1 日のみです。 既定値は現在の日付です (今日が火曜日の場合、火曜日が既定値です)。 このパラメーターの有効値は、次のとおりです。
- 月曜日
- Tuesday
- 水曜日
- 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
仮想マシン マネージャー (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 ヒント) の ID を指定します。 このパラメーターを使用すると、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
同じ標準時間を共有する地理的リージョンを識別する数値 (インデックス) を指定します。
タイム ゾーン インデックスの一覧については、「Microsoft タイム ゾーン インデックスの値http://go.microsoft.com/fwlink/?LinkId=120935」を参照してください。
タイム ゾーンが指定されていない場合、仮想マシンに使用される既定のタイム ゾーンは、仮想マシン ホスト上にあるのと同じタイム ゾーン設定になります。
| 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 日以上の曜日を指定します。 既定値は、現在の曜日です。
- 文字列を使用して個々の日を指定する有効な値: 月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日。
- 1 週間の日数のセットを指定する有効な値: コンマで区切られた 2 日以上の任意のセット。
- 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
最初、2 番目、3 番目、4 番目、最後など、月の最初の日を基準とした週を指定します。
| 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 の最小値です。 最大値はありません。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
出力
ServicingWindow
このコマンドレットは 、ServicingWindow オブジェクトを 返します。