Set-SmaAdminConfiguration
Modifie les paramètres de configuration d’administration dans SMA.
Syntaxe
Set-SmaAdminConfiguration
[-Telemetry <Boolean>]
[-DrainTimeInSeconds <Int32>]
[-ScriptExecutionPolicy <String>]
[-MaxJobRecords <Int32>]
[-PurgeJobsOlderThanCountDays <Int32>]
[-Force]
[-ChartTimeSliceSampleSize <ChartTimeSliceSampleSize>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-SmaAdminConfiguration modifie les paramètres de configuration d’administration dans Service Management Automation (SMA). Spécifiez le point de terminaison du service web et, si nécessaire, un port.
Utilisez cette applet de commande pour configurer les paramètres suivants :
- Indique s’il faut partager des données de diagnostic et d’utilisation avec Microsoft
- Temps de drainage
- Stratégie d’exécution de script
- Taille de l’exemple de tranche de temps du graphique
- Nombre maximal d’enregistrements de travaux à stocker avant de purger les travaux les plus anciens
- Âge maximal d’un travail avant d’être vidé
Exemples
Exemple 1 : Modifier un paramètre de configuration d’administration
PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60
Cette commande définit la durée de drainage sur 60 secondes.
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 |
-ChartTimeSliceSampleSize
Spécifie la taille de l’exemple de tranche de temps du graphique. Les valeurs valides sont les suivantes :
- Petit
- Douleur moyenne
- Grand
- ExtraLarge
Type: | ChartTimeSliceSampleSize |
Valeurs acceptées: | Small, Medium, Large, ExtraLarge |
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 |
-DrainTimeInSeconds
Spécifie l’heure, en secondes, après laquelle les hôtes runbook Worker terminent les travaux en cours d’exécution après qu’un arrêt de service runbook Worker a été lancé. Pendant le drainage de l’hôte, les travaux existants reçoivent les secondes de temps de drainage spécifiées pour suspendre ou se terminer naturellement, et aucun nouveau travail n’est accepté.
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 |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-MaxJobRecords
Spécifie le nombre maximal d’enregistrements de travail conservés.
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 |
-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 |
-PurgeJobsOlderThanCountDays
Spécifie le nombre de jours pendant lesquels l’historique des travaux est conservé. Les travaux antérieurs à cette valeur sont vidés.
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 |
-ScriptExecutionPolicy
Détermine la stratégie d’exécution de Windows PowerShell pour les travaux de runbook sur les hôtes worker.
Pour plus d’informations sur les stratégies d’exécution, tapez Get-Help about_Execution_Policies
.
Les valeurs valides pour ce paramètre sont les suivantes :
- Restreint. Vous ne pouvez pas exécuter de scripts. Vous pouvez utiliser Windows PowerShell uniquement en mode interactif.
- AllSigned. Vous pouvez exécuter uniquement des scripts signés par un éditeur approuvé.
- RemoteSigned. Les scripts téléchargés doivent être signés par un éditeur approuvé avant de pouvoir exécuter les scripts.
- Illimité. Aucune restriction ; vous pouvez exécuter tous les scripts Windows PowerShell.
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 |
-Telemetry
Indique s’il faut partager des données de diagnostic et d’utilisation avec Microsoft. Les valeurs acceptables pour ce paramètre sont les suivantes :
- $True. Partagez des données de diagnostic et d’utilisation avec Microsoft.
- $False. Ne partagez pas les données de diagnostic et d’utilisation avec Microsoft.
Type: | Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
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 |