managed_backup.sp_set_parameter (Transact-SQL)

適用於：SQL Server 2016 (13.x) 和更新版本

設定指定之 Smart Admin 系統參數的值。

可用的參數與 SQL Server 受控備份Microsoft Azure 相關。 這些參數可用來設定電子郵件通知、啟用特定的擴充事件，以及啟用使用者設定原則式管理原則。 您必須指定參數名稱和參數值組。

Transact-SQL 語法慣例

語法

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

引數

[ @parameter_name = ] N'parameter_name'

您要為設定值的參數名稱。 @parameter_name是 nvarchar（128）。 可用的參數名稱如下：

• SSMBackup2WANotificationEmailIds
• SSMBackup2WADebugXevent
• SSMBackup2WAEnableUserDefinedPolicy
• FileRetentionDebugXevent
• StorageOperationDebugXevent.

[ @parameter_value = ] N'parameter_value'

您要設定之參數的值。 @parameter_value是 nvarchar（128）。 下表顯示允許的參數名稱與值群組：

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

傳回碼值

0 (成功) 或 1 (失敗)。

權限

需要預存程式的 EXECUTE 許可權 managed_backup.sp_set_parameter 。

範例

下列範例會啟用操作和偵錯擴充事件。

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

下列範例會啟用錯誤和警告的電子郵件通知，並設定傳送通知的電子郵件位址：

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