Partager via


Set-SCServicingWindow

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

Syntax

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

L’applet de commande 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 (sauvegarde intermédiaire A) à 13h00 dans le fuseau horaire GMT Standard.

Paramètres

-Category

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

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

-DayOfMonth

Spécifie le jour ordinal du mois sur lequel démarre 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
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

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

-Description

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

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

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 le mardi est mardi, mardi est la valeur par défaut). Les valeurs valides pour ce paramètre sont :

  • Lundi
  • Mardi
  • Mercredi
  • Thursday
  • Vendredi
  • Samedi
  • Dimanche

Condition requise : utiliser avec le paramètre 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

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

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-ServicingWindow

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

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

-StartDate

Spécifie la date de démarrage d’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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTimeOfDay

Spécifie l’heure de la journée, ou 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 à l’adresse 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 qui se trouve sur l’hôte de la machine virtuelle.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 jours ou plus 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WeekOfMonth

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

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

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

Sorties

ServicingWindow

Cette applet de commande retourne un objet ServicingWindow .