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
La deuxième commande crée un objet date à l’aide de l’applet de commande Get-Date 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
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 |