New-AzAutomationSchedule
Crée une planification Automation.
Syntaxe
ByDaily (Par défaut)
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-DayInterval <Byte>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByWeekly
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-WeekInterval <Byte>
[-Description <String>]
[-DaysOfWeek <DayOfWeek[]>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByMonthlyDaysOfMonth
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-MonthInterval <Byte>
[-Description <String>]
[-DaysOfMonth <DaysOfMonth[]>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByMonthlyDayOfWeek
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-MonthInterval <Byte>
[-Description <String>]
[-DayOfWeek <DayOfWeek>]
[-DayOfWeekOccurrence <DayOfWeekOccurrence>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByOneTime
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-Description <String>]
[-OneTime]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByHourly
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-HourInterval <Byte>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande New-AzAutomationSchedule crée une planification dans Azure Automation.
Exemples
Exemple 1 : Créer une planification ponctuelle dans l’heure locale
$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
La première commande obtient l’ID de fuseau horaire du système et la stocke dans la variable $TimeZone.
La deuxième commande crée une planification qui s’exécute une fois à la date actuelle à 11h00 dans le fuseau horaire spécifié.
Exemple 2 : Créer une planification ponctuelle dans un autre fuseau horaire
$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
La première commande initialise une variable $TimeZone avec la valeur Europe/Paris La deuxième commande crée une planification qui s’exécute une seule fois à la date actuelle à 23:00 UTC dans le fuseau horaire spécifié.
Remarque : Schedule StartTime est calculé en ajoutant le décalage TimeZone à l’heure de début fournie
Exemple 3 : Créer une planification périodique
$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"
La première commande crée un objet date à l’aide de l’applet de commande Get-Date , puis stocke l’objet dans la variable $StartDate.
Spécifiez une heure d’au moins cinq minutes à l’avenir.
La deuxième commande crée un objet date à l’aide de l’applet de commande Get-Date , puis stocke l’objet dans la variable $EndDate.
La commande spécifie une heure ultérieure.
La commande finale crée une planification quotidienne nommée Schedule02 pour commencer à l’heure stockée dans $StartDate et expirer à l’heure stockée dans $EndDate.
Exemple 4 : Créer une planification périodique hebdomadaire
$StartTime = (Get-Date "13:00:00").AddDays(1)
[System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule03" -StartTime $StartTime -WeekInterval 1 -DaysOfWeek $WeekDays -ResourceGroupName "ResourceGroup01"
La première commande crée un objet date à l’aide de l’applet de commande Get-Date , puis stocke l’objet dans la variable $StartDate.
La deuxième commande crée un tableau de jours de semaine qui contient lundi, mardi, mercredi, jeudi et vendredi.
La commande finale crée une planification quotidienne nommée Schedule03 qui s’exécutera lundi à vendredi chaque semaine à 13h00. La planification n’expirera jamais.
Paramètres
-AutomationAccountName
Spécifie le nom d’un compte Automation pour lequel cette applet de commande crée une planification.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 1 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-DayInterval
Spécifie un intervalle, en jours, pour la planification.
Si vous ne spécifiez pas ce paramètre et que vous ne spécifiez pas le paramètre OneTime , la valeur par défaut est une (1).
Propriétés du paramètre
Type: Byte
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByDaily
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DayOfWeek
Spécifie la liste des jours de la semaine pour la planification hebdomadaire.
Propriétés du paramètre
Type: Nullable<T> [ DayOfWeek ]
Valeur par défaut: None Valeurs acceptées: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByMonthlyDayOfWeek
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DayOfWeekOccurrence
Spécifie l’occurrence de la semaine dans le mois pendant lequel la planification s’exécute.
psdx_paramvalues
1
2
3
4
-1
Premier
Second
Third
Quatrième
LastDay
Propriétés du paramètre
Type: DayOfWeekOccurrence
Valeur par défaut: None Valeurs acceptées: First, Second, Third, Fourth, Last Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByMonthlyDayOfWeek
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DaysOfMonth
Spécifie la liste des jours du mois pour la planification mensuelle.
Propriétés du paramètre
Type: DaysOfMonth [ ]
Valeur par défaut: None Valeurs acceptées: One, Two, Three, Four, Five, Six, Seventh, Eighth, Ninth, Tenth, Eleventh, Twelfth, Thirteenth, Fourteenth, Fifteenth, Sixteenth, Seventeenth, Eighteenth, Nineteenth, Twentieth, TwentyFirst, TwentySecond, TwentyThird, TwentyFourth, TwentyFifth, TwentySixth, TwentySeventh, TwentyEighth, TwentyNinth, Thirtieth, ThirtyFirst, LastDay Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByMonthlyDaysOfMonth
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DaysOfWeek
Spécifie la liste des jours de la semaine pour la planification hebdomadaire.
Propriétés du paramètre
Type: DayOfWeek [ ]
Valeur par défaut: None Valeurs acceptées: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByWeekly
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Description
Spécifie une description de la planification.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-ExpiryTime
Spécifie l’heure d’expiration d’une planification en tant qu’objet DateTimeOffset .
Vous pouvez spécifier une chaîne qui peut être convertie en dateTimeOffset valide.
Propriétés du paramètre
Type: DateTimeOffset
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByDaily
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
ByWeekly
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
ByMonthlyDaysOfMonth
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
ByMonthlyDayOfWeek
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
ByHourly
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ForUpdateConfiguration
Indique que cet objet de planification sera utilisé pour planifier une configuration de mise à jour logicielle
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-HourInterval
Spécifie un intervalle, en heures, pour la planification.
Propriétés du paramètre
Type: Byte
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByHourly
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-MonthInterval
Spécifie un intervalle, en mois, pour la planification.
Propriétés du paramètre
Type: Byte
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByMonthlyDaysOfMonth
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
ByMonthlyDayOfWeek
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Name
Spécifie un nom pour la planification.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 2 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-OneTime
Spécifie que l’applet de commande crée une planification ponctuelle.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByOneTime
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ResourceGroupName
Spécifie le nom d’un groupe de ressources pour lequel cette applet de commande crée une planification.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 0 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-StartTime
Spécifie l’heure de début d’une planification en tant qu’objet DateTimeOffset .
Vous pouvez spécifier une chaîne qui peut être convertie en dateTimeOffset valide.
Si le fuseau horaire est fourni, StartTime est calculé en ajoutant le décalage du fuseau horaire d’entrée.
Propriétés du paramètre
Type: DateTimeOffset
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 3 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-TimeZone
Spécifie le fuseau horaire de la planification.
Cette chaîne peut être l’ID IANA ou l’ID de fuseau horaire Windows.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-WeekInterval
Spécifie un intervalle, en semaines, pour la planification.
Propriétés du paramètre
Type: Byte
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
ByWeekly
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
