Partager via

sp_syspolicy_configure (Transact-SQL)

  • Article

S’applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @name = ] N’name'

Nom du paramètre que vous souhaitez configurer. @name est sysname, est obligatoire et ne peut pas être NULL ou une chaîne vide.

@name peut être 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 d’évaluation de la stratégie doit être conservé. Si la valeur est définie 0, l’historique n’est pas automatiquement supprimé.

  • LogOnSuccess - Spécifie si la gestion basée sur des stratégies enregistre les évaluations de stratégie réussies.

[ @value = ] value

Valeur associée à la valeur spécifiée pour @name. @value est sql_variant et est nécessaire.

  • Si vous spécifiez « Activé » 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 sous forme de valeur entière.

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

    • 0 - Journalise uniquement les évaluations de stratégie ayant échoué.
    • 1 - Journalise les évaluations de stratégie réussies et 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 msdb base de données système.

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

autorisations

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

Important

É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 l’opération 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 plupart des objets d’être créés dans le Moteur de base de données. En raison de cette élévation possible d’informations d’identification, le rôle PolicyAdministratorRole doit être accordé uniquement aux utilisateurs approuvés pour 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

Contenu connexe