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

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 future. 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
  • First
  • Second
  • Third
  • 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 fuseau horaire est fourni, StartTime est calculé en ajoutant le décalage du fuseau horaire d’entrée.

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