Partager via


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