Set-SCServicingWindow

サービス ウィンドウのプロパティを変更します。

構文

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-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>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-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>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-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>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DaysToRecur <Int32>
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCServicingWindow コマンドレットは、サービス ウィンドウのスケジュールなど、サービス ウィンドウのプロパティを変更します。

例 1: サービス期間の開始時刻を変更する

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A" 
PS C:\> Set-SCServicingWindow -ServicingWindow $SvcWindow -StartTimeOfDay "13:00" -TimeZone 085

最初のコマンドは、Backup Staging A という名前のサービス ウィンドウ オブジェクトを取得し、$SvcWindow変数にオブジェクトを格納します。

2 番目のコマンドは、$SvcWindow (バックアップ ステージング A) に格納されているサービス ウィンドウの開始時刻を GMT 標準タイム ゾーンの午後 1 時に変更します。

パラメーター

-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:Named
Default value:None
Required:False
Accept pipeline input:False
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

-ServicingWindow

サービス ウィンドウ オブジェクトを指定します。

Type:ServicingWindow
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-WeeklyScheduleDayOfWeek

ジョブを実行する曜日を 1 日以上指定します。 既定値は、現在の曜日です。

文字列を使用して個々の日を指定する有効な値: 月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日。

1 週間の日数のセットを指定する有効な値: コンマで区切られた 2 日以上の任意のセット。

整数を使用して個々の日を指定する有効な値: 1、2、3、4、5、6、7

要件: StartTimeOfDay で使用します。

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

このコマンドレットは 、ServiceingWindow オブジェクトを 返します。