sp_syspolicy_configure (Transact-SQL)

Configure des paramètres pour la Gestion basée sur des stratégies, tels que l'activation, ou non, de cette dernière.

S'applique à : SQL Server (SQL Server 2008 jusqu'à la version actuelle).

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_syspolicy_configure [ @name = ] 'name'
    , [ @value = ] value

Arguments

• [ @name =] 'name'
  Nom du paramètre à configurer. name est de type sysname, est obligatoire et ne peut pas avoir la valeur NULL ou être une chaîne vide.

  name peut prendre l'une des valeurs suivantes :

  • 'Enabled' - Détermine si la Gestion basée sur des stratégies est activée.

  • 'HistoryRetentionInDays' - Spécifie le nombre de jours pendant lesquels l'historique des évaluations de stratégies doit être conservé. Si la valeur est 0, l'historique n'est pas supprimé automatiquement.

  • 'LogOnSuccess' - Spécifie si la Gestion basée sur des stratégies consigne les évaluations de stratégies réussies.

• [ @value = ] value
  Valeur associée à la valeur spécifiée pour name. value est de type sql_variant et est obligatoire.

  • Si vous spécifiez 'Enabled' pour name, vous pouvez utiliser l'une des valeurs suivantes :

    • 0 = Désactive la Gestion basée sur des stratégies.

    • 1 = Active la Gestion basée sur des stratégies.

  • Si vous spécifiez 'HistoryRententionInDays' pour name, spécifiez le nombre de jours comme valeur entière.

  • Si vous spécifiez 'LogOnSuccess' pour name, vous pouvez utiliser l'une des valeurs suivantes :

    • 0 = Consigne uniquement les évaluations de stratégies ayant échoué.

    • 1 = Consigne aussi bien les évaluations de stratégies réussies que celles ayant échoué.

Valeurs des codes de retour

0 (réussite) ou 1 (échec)

Notes

Vous devez exécuter sp_syspolicy_configure dans le contexte de la base de données système msdb.

Pour consulter les valeurs actuelles de ces paramètres, interrogez la vue système msdb.dbo.syspolicy_configuration.

Autorisations

Nécessite l'appartenance au rôle de base de données fixe PolicyAdministratorRole.

Remarque relative à la sécurité

Élévation possible des informations d'identification : les utilisateurs du rôle PolicyAdministratorRole peuvent créer des déclencheurs de serveur et planifier des exécutions de stratégie qui peuvent affecter le fonctionnement de l'instance du Moteur de base de données.Par exemple, les utilisateurs du rôle PolicyAdministratorRole peuvent créer une stratégie qui peut empêcher la création de la plupart des objets dans le Moteur de base de données.Étant donné cette possible élévation des informations d'identification, le rôle PolicyAdministratorRole doit être accordé uniquement aux utilisateurs de confiance autorisés à contrôler la configuration du moteur de base de données.

Exemples

L'exemple suivant active la Gestion basée sur des stratégies.

EXEC msdb.dbo.sp_syspolicy_configure @name = N'Enabled'
, @value = 1;

GO

L'exemple suivant définit la rétention de l'historique de la stratégie à 14 jours.

EXEC msdb.dbo.sp_syspolicy_configure @name = N'HistoryRetentionInDays'
, @value = 14;

GO

L'exemple suivant configure la Gestion basée sur des stratégies pour qu'aussi bien les évaluations de stratégies réussies que celles ayant échoué soient consignées.

EXEC msdb.dbo.sp_syspolicy_configure @name = N'LogOnSuccess'
, @value = 1;

GO

Voir aussi

Référence

Procédures stockées de Gestion basée sur des stratégies (Transact-SQL)

sp_syspolicy_set_config_enabled (Transact-SQL)

sp_syspolicy_set_config_history_retention (Transact-SQL)

sp_syspolicy_set_log_on_success (Transact-SQL)