managed_backup.sp_set_parameter (Transact-SQL)

  • Artikel

Gilt für: SQL Server 2016 (13.x) und höhere Versionen

Legt den Wert des angegebenen Smart Admin-Systemparameters fest.

Die verfügbaren Parameter beziehen sich auf die verwaltete SQL Server-Sicherung auf Microsoft Azure. Mit diesen Parametern werden die E-Mail-Benachrichtigungen festgelegt, bestimmte erweiterte Ereignisse aktiviert und auf benutzerdefinierten Richtlinien basierende Verwaltungsrichtlinien aktiviert. Sie müssen den Parameternamen und die Parameterwertpaare angeben.

Transact-SQL-Syntaxkonventionen

Syntax

EXEC managed_backup.sp_set_parameter
    [ @parameter_name = ] {
        N'SSMBackup2WANotificationEmailIds'
        | N'SSMBackup2WAEnableUserDefinedPolicy'
        | N'SSMBackup2WADebugXevent'
        | N'FileRetentionDebugXevent'
        | N'StorageOperationDebugXevent'
    }
    , [ @parameter_value = ] N'parameter_value'
[ ; ]

Argumente

[ @parameter_name = ] N'parameter_name'

Der Name des Parameters, dessen Wert festgelegt werden soll. @parameter_name ist nvarchar(128). Die verfügbaren Parameternamen sind:

  • SSMBackup2WANotificationEmailIds
  • SSMBackup2WADebugXevent
  • SSMBackup2WAEnableUserDefinedPolicy
  • FileRetentionDebugXevent
  • StorageOperationDebugXevent.

[ @parameter_value = ] N'parameter_value'

Der Wert des Parameters, der festgelegt werden soll. @parameter_value ist nvarchar(128). In der folgenden Tabelle sind zulässige Parameternamen und Wertpaare aufgeführt:

@parameter_name @parameter_value
'SSMBackup2WANotificationEmailIds' 'email'
'SSMBackup2WAEnableUserDefinedPolicy' { 'true' | 'false' }
'SSMBackup2WADebugXevent' { 'true' | 'false' }
'FileRetentionDebugXevent' { 'true' | 'false' }
'StorageOperationDebugXevent' = { 'true' | 'false' } N/V

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Berechtigungen

Erfordert EXECUTE-Berechtigungen für die managed_backup.sp_set_parameter gespeicherte Prozedur.

Beispiele

In den folgenden Beispielen werden erweiterte operationale und Debugereignisse aktiviert.

-- Enable operational events
USE msdb;
GO
EXEC managed_backup.sp_set_parameter N'FileRetentionOperationalXevent', N'True';

-- Enable debug events
USE msdb;
GO
EXEC managed_backup.sp_set_parameter N'FileRetentionDebugXevent', N'True';

Im folgenden Beispiel werden E-Mail-Benachrichtigungen über Fehler und Warnungen aktiviert und die E-Mail-Adresse für das Senden von Benachrichtigungen festgelegt:

USE msdb;
GO
EXEC managed_backup.sp_set_parameter @parameter_name = 'SSMBackup2WANotificationEmailIds', @parameter_value = '<email address>';