Partager via

New-SCServicingWindow

  • Référence
Module:
VirtualMachineManager

Crée une fenêtre de maintenance et la planification de la fenêtre de maintenance.

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

L’applet de commande New-SCServicingWindow crée une fenêtre de maintenance et la planification de la fenêtre de maintenance. Une fenêtre de maintenance est une période planifiée pendant laquelle le travail de maintenance peut être effectué sur une machine virtuelle, un hôte ou un service.

Exemples

Exemple 1 : Planifier une fenêtre de maintenance quotidienne

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

La première commande obtient la date actuelle et ajoute deux jours, puis stocke le résultat dans la variable $Date.

La deuxième commande crée une fenêtre de maintenance nommée Sauvegarde intermédiaire A qui se produit tous les trois jours à 13 h 30 dans le fuseau horaire GMT Standard. La date de début de la fenêtre de maintenance est définie sur la date stockée dans $Date, qui est en deux jours.

Exemple 2 : Planifier une fenêtre de maintenance qui se produit un jour par semaine

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

La première commande obtient la date actuelle et ajoute sept jours (une semaine), puis stocke le résultat dans la variable $Date.

La deuxième commande crée une fenêtre de maintenance nommée Groupe de serveurs de test 3 qui se produit chaque semaine à partir de 11h00 dans le fuseau horaire de l’Est et dure 3 heures (180 minutes). La date de début de la fenêtre de maintenance est définie sur la date stockée dans $Date, qui est en sept jours (une semaine).

Exemple 3 : Planifier une fenêtre de service biweekly

PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2

Cette commande crée une fenêtre de maintenance nommée Groupe intermédiaire C qui se produit toutes les autres semaines (toutes les semaines) le samedi et le dimanche à partir de 10 h 30 dans le fuseau horaire de l’Est. Étant donné qu’aucune date de début n’est spécifiée, par défaut, la fenêtre de maintenance devient effective aujourd’hui.

Exemple 4 : Planifier une fenêtre de maintenance bi mensuelle

PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2

Cette commande crée une fenêtre de maintenance nommée Serveurs de production A qui se produit tous les autres mois (tous les mois) le deuxième mardi du mois, à partir de 11h30 dans le fuseau horaire de l’Est. Étant donné qu’aucune date de début n’est spécifiée, par défaut, la fenêtre de maintenance devient effective aujourd’hui.

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

-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

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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
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 .