New-SCServicingWindow
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 3La 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 180La 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 2Cette 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 2Cette 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 .