Partager via


Set-SmaSchedule

Crée ou modifie une planification dans SMA.

Syntax

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

Description

L’applet de commande 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 pouvez modifier uniquement 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 future. Pour plus d'informations, voir 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 autorisées sont :

  • De base
  • 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
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, voir Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Fournit une description de la planification.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, voir Get-Help Get-Date.

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom d’une planification.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Port

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleType

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

  • OneTimeSchedule
  • DailySchedule
Type:String
Accepted values:OneTimeSchedule, DailySchedule
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False