New-AzureRMAutomationSchedule
Crée une planification Automation.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntax
New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
-DayInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DaysOfWeek <DayOfWeek[]>]
[-ExpiryTime <DateTimeOffset>]
-WeekInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DaysOfMonth <DaysOfMonth[]>]
[-ExpiryTime <DateTimeOffset>]
-MonthInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-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-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-OneTime]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-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-AzureRmAutomationSchedule crée une planification dans Azure Automation.
Exemples
Exemple 1 : Créer une planification ponctuelle dans l’heure locale
PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZoneLa 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 périodique
PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureRmAutomationSchedule -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 3 : Créer une planification périodique hebdomadaire
PS C:\> $StartTime = (Get-Date "13:00:00").AddDays(1)
PS C:\> [System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
PS C:\> New-AzureRmAutomationSchedule -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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DayOfWeek
Spécifie la liste des jours de la semaine pour la planification hebdomadaire.
| Type: | Nullable<T>[DayOfWeek] |
| Accepted values: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Accepted values: | First, Second, Third, Fourth, Last |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysOfMonth
Spécifie la liste des jours du mois pour la planification mensuelle.
| Type: | DaysOfMonth[] |
| Accepted values: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysOfWeek
Spécifie la liste des jours de la semaine pour la planification hebdomadaire.
| Type: | DayOfWeek[] |
| Accepted values: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Spécifie une description de la planification.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExpiryTime
Spécifie l’heure d’expiration d’une planification en tant qu’objet DateTimeOffest . Vous pouvez spécifier une chaîne qui peut être convertie en dateTimeOffset valide.
| Type: | DateTimeOffset |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForUpdateConfiguration
Indique que cet objet de planification sera utilisé pour planifier une configuration de mise à jour logicielle
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HourInterval
Spécifie un intervalle, en heures, pour la planification.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonthInterval
Spécifie un intervalle, en mois, pour la planification.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Spécifie un nom pour la planification.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OneTime
Spécifie que l’applet de commande crée une planification ponctuelle.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 paramètre TimeZone est spécifié, le décalage est ignoré et le fuseau horaire spécifié est utilisé.
| Type: | DateTimeOffset |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WeekInterval
Spécifie un intervalle, en semaines, pour la planification.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |