Partager via


Set-SCServicingWindow

Modifie les propriétés d’une fenêtre de maintenance.

Syntaxe

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

Description

La cmdlet Set-SCServicingWindow modifie les propriétés d’une fenêtre de maintenance, y compris la planification de la fenêtre de maintenance.

Exemples

Exemple 1 : Modifier l’heure de début d’une fenêtre de maintenance

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

La première commande obtient l’objet de fenêtre de maintenance nommé Backup Staging A et stocke l’objet dans la variable $SvcWindow.

La deuxième commande modifie l’heure de début de la fenêtre de maintenance stockée dans $SvcWindow (préproduction de sauvegarde A) à 13 h 00 dans le fuseau horaire GMT Standard.

Paramètres

-Category

Spécifie une catégorie pour une fenêtre de maintenance.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DayOfMonth

Spécifie le jour ordinal du mois au démarrage de la planification. Par exemple, 4 indique le quatrième jour du mois. La dernière indique le dernier jour du mois.

La valeur par défaut est l’entier qui correspond au même jour que spécifié dans le paramètre StartDate.

Valeurs entières valides : 1 - 31

Valeurs de chaîne valides : First, Last

Type:DayOfMonthType
Valeurs acceptées: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DaysToRecur

Spécifie la durée, en jours, entre les travaux planifiés. La valeur par défaut est la valeur minimale d’un (1). La valeur maximale est 999.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description de la fenêtre de maintenance.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MinutesDuration

Spécifie une période de temps en minutes. Utilisez ce paramètre pour spécifier la durée pendant laquelle placer un serveur ou un service en mode maintenance.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonthlyScheduleDayOfWeek

Spécifie le jour de la semaine pour exécuter un travail qui se produit selon une planification mensuelle. Vous ne pouvez spécifier qu’un seul jour de la semaine. La valeur par défaut est le jour actuel (si aujourd’hui est mardi, mardi est la valeur par défaut). Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Lundi
  • Mardi
  • Mercredi
  • Jeudi
  • Vendredi
  • Samedi
  • Dimanche

Condition requise : utilisez le paramètre WeekOfMonth .

Type:DayOfWeek
Valeurs acceptées:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonthsToRecur

Spécifie la durée, en mois, entre les fenêtres de service planifiées. La valeur par défaut est la valeur minimale d’un (1). Il n’y a pas de valeur maximale.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet Virtual Machine Manager (VMM).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Owner

Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicingWindow

Spécifie un objet de fenêtre de maintenance.

Type:ServicingWindow
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-StartDate

Spécifie la date à laquelle démarrer une fenêtre de service. La valeur par défaut est la date actuelle. Vous pouvez taper une nouvelle date au format de date court pour vos paramètres régionaux, ou passer un objet DateTime à partir de Get-Date.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StartTimeOfDay

Spécifie l’heure de la journée, ou un intervalle de temps pendant une période de 24 heures, pour démarrer un travail ou une autre opération. La valeur par défaut est l’heure actuelle.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeZone

Spécifie un nombre (index) qui identifie une région géographique qui partage le même temps standard. Pour obtenir la liste des index de fuseau horaire, consultez valeurs d’index de fuseau horaire Microsoft à http://go.microsoft.com/fwlink/?LinkId=120935. Si aucun fuseau horaire n’est spécifié, le fuseau horaire par défaut utilisé pour une machine virtuelle est le même paramètre de fuseau horaire sur l’hôte de la machine virtuelle.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WeeklyScheduleDayOfWeek

Spécifie un ou plusieurs jours de la semaine pour exécuter un travail. La valeur par défaut est le jour actuel de la semaine.

Valeurs valides pour spécifier un jour individuel à l’aide d’une chaîne : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche.

Valeurs valides pour spécifier un ensemble de jours dans une semaine : tout ensemble de deux ou plusieurs jours séparés par des virgules.

Valeurs valides pour spécifier un jour individuel à l’aide d’un entier : 1, 2, 3, 4, 5, 6, 7

Condition requise : utiliser avec StartTimeOfDay.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WeekOfMonth

Spécifie une semaine par rapport au premier jour du mois, par exemple le premier, le deuxième, le troisième, le quatrième ou le dernier.

Type:WeekOfMonthType
Valeurs acceptées:First, Second, Third, Fourth, Last
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WeeksToRecur

Spécifie la durée, en semaines, entre les travaux planifiés. La valeur par défaut est la valeur minimale d’un (1). Il n’y a pas de valeur maximale.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

ServicingWindow

Cette applet de commande retourne un objet ServicingWindow.