Partager via


Set-SmaSchedule

Crée ou modifie une planification dans SMA.

Syntaxe

Set-SmaSchedule
   -Name <String>
   [-Description <String>]
   -ScheduleType <String>
   -StartTime <DateTime>
   -ExpiryTime <DateTime>
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-SmaSchedule crée ou modifie une planification dans Service Management Automation (SMA). Spécifiez le nom et le type de la planification, ainsi que les heures de début et de fin.

Vous ne pouvez modifier que la description lorsque vous exécutez cette applet de commande sur une planification existante. L’heure de début, l’heure d’expiration et l’intervalle de jour ne peuvent être définis que lors de la création d’une planification avec cette applet de commande.

Exemples

Exemple 1 : Créer une planification

PS C:\> $StartDate = Get-Date 
PS C:\> $EndDate = Get-Date -Day 12 -Month 6 -Year 2023
PS C:\> Set-SmaSchedule -StartTime $StartDate -ExpiryTime $EndDate -Name "Schedule01" -ScheduleType "DailySchedule" -WebServiceEndpoint "https://contoso.com/app01"

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. Cet objet reflète l’heure actuelle.

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. Pour plus d’informations, tapez Get-Help Get-Date.

La dernière commande définit la planification nommée Schedule01 pour commencer à l’heure stockée dans $StartDate et se terminer à l’heure stockée dans $EndDate

Paramètres

-AuthenticationType

Spécifie le type d’authentification. Les valeurs valides sont les suivantes :

  • Basique
  • Windows

La valeur par défaut de ce paramètre est Windows. Si vous utilisez l’authentification de base, vous devez fournir des informations d’identification à l’aide du paramètre Credential.

Type:String
Valeurs acceptées:Basic, Windows
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un objet PSCredential pour la connexion au service web SMA. Pour obtenir un objet d’informations d’identification, utilisez l’applet de commande Get-Credential. Pour plus d’informations, tapez Get-Help Get-Credential.

Type:PSCredential
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

Fournit une description de la planification.

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

-ExpiryTime

Spécifie quand, en tant qu’objet DateTime, la planification se termine. Pour obtenir un objet DateTime, utilisez l’applet de commande Get-Date. Pour plus d’informations, tapez Get-Help Get-Date.

Type:DateTime
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 le nom d’une planification.

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

-Port

Spécifie le numéro de port du service web SMA.

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

-ScheduleType

Spécifie le type de planification. Les valeurs valides pour ce paramètre sont les suivantes :

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

-StartTime

Spécifie quand, en tant qu’objet DateTime, la planification démarre. Pour obtenir un objet DateTime, utilisez l’applet de commande Get-Date .

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

-WebServiceEndpoint

Spécifie le point de terminaison, en tant qu’URL, du service web SMA. Vous devez inclure le protocole, par exemple, http:// ou https://.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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