Partager via

New-AzAutomationSchedule

  • Référence
Module:
Az.Automation

Crée une planification Automation.

Syntaxe

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-ExpiryTime <DateTimeOffset>]
   -WeekInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfMonth <DaysOfMonth[]>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DayOfWeek <DayOfWeek>]
   [-DayOfWeekOccurrence <DayOfWeekOccurrence>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

La cmdlet 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 fois à la date actuelle à 23:00 UTC dans le fuseau horaire spécifié.

Remarque : La planification StartTime est calculée en ajoutant le décalage de fuseau horaire StartTime fourni

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.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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).

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

-DayOfWeek

Spécifie la liste des jours de la semaine pour la planification hebdomadaire.

Type:Nullable<T>[DayOfWeek]
Valeurs acceptées:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
  • Deuxième
  • Troisième
  • Quatrième
  • LastDay
Type:DayOfWeekOccurrence
Valeurs acceptées:First, Second, Third, Fourth, Last
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DaysOfMonth

Spécifie la liste des jours du mois pour la planification mensuelle.

Type:DaysOfMonth[]
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
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DaysOfWeek

Spécifie la liste des jours de la semaine pour la planification hebdomadaire.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description de la planification.

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

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

-ForUpdateConfiguration

Indique que cet objet de planification sera utilisé pour planifier une configuration de mise à jour logicielle

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

-HourInterval

Spécifie un intervalle, en heures, pour la planification.

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

-MonthInterval

Spécifie un intervalle, en mois, pour la planification.

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

-Name

Spécifie un nom pour la planification.

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

-OneTime

Spécifie que l’applet de commande crée une planification ponctuelle.

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

-ResourceGroupName

Spécifie le nom d’un groupe de ressources pour lequel cette applet de commande crée une planification.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 TimeZone est fourni, StartTime est calculé en ajoutant le décalage d’entrée fuseau horaire.

Type:DateTimeOffset
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

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

-WeekInterval

Spécifie un intervalle, en semaines, pour la planification.

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

Entrées

String

DateTimeOffset

SwitchParameter

Sorties

Schedule