Share via


Set-SmaAdminConfiguration

Modifie les paramètres de configuration d’administration dans SMA.

Syntax

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 de 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
  • L’âge maximal d’un emploi avant qu’il ne soit purgé

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 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

-ChartTimeSliceSampleSize

Spécifie la taille de l’exemple de tranche de temps du graphique. Les valeurs autorisées sont :

  • Petite
  • Moyenne
  • grand
  • Très grande
Type:ChartTimeSliceSampleSize
Accepted values:Small, Medium, Large, ExtraLarge
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

-DrainTimeInSeconds

Spécifie la durée, en secondes, après laquelle les hôtes Runbook Worker terminent les travaux en cours d’exécution après le lancement d’un arrêt du service Runbook Worker. 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-MaxJobRecords

Spécifie le nombre maximal d’enregistrements de travaux conservés.

Type:Int32
Position:Named
Default value:None
Required:False
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

-PurgeJobsOlderThanCountDays

Spécifie le nombre de jours pendant lesquels l’historique des travaux est conservé. Les travaux antérieurs à cette valeur sont purgés.

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

-ScriptExecutionPolicy

Détermine la stratégie d’exécution 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.
  • Sans restriction. Aucune restriction; vous pouvez exécuter tous les scripts Windows PowerShell.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Telemetry

Indique s’il faut partager des données de diagnostic et d’utilisation avec Microsoft. Les valeurs valides pour ce paramètre sont :

  • $True. Partagez les 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
Default value:None
Required:False
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