sp_syspolicy_rename_policy (Transact-SQL)
Aplica-se: SQL Server
Renomeia uma política existente no Gerenciamento Baseado em Políticas.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_syspolicy_rename_policy
{ [ @name = ] N'name' | [ @policy_id = ] policy_id }
, [ @new_name = ] N'new_name'
[ ; ]
Argumentos
[ @name = ] N'name'
O nome da política que você deseja renomear. @name é sysname e deve ser especificado se @policy_id for NULL
.
@policy_id [ = ] policy_id
O identificador da política que você deseja renomear. @policy_id é int e deve ser especificado se @name for NULL
.
@new_name [ = ] N'new_name'
O novo nome da política. @new_name é sysname e é obrigatório. Não pode ser NULL
ou uma string vazia.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Comentários
Você deve executar sp_syspolicy_rename_policy
no contexto do banco de dados do msdb
sistema.
Você deve especificar um valor para @name ou @policy_id. Ambos não podem ser NULL
. Para obter esses valores, consulte a exibição do msdb.dbo.syspolicy_policies
sistema.
Permissões
Requer associação na função de banco de dados fixa PolicyAdministratorRole .
Importante
Possível elevação de credenciais: os usuários na função PolicyAdministratorRole podem criar gatilhos de servidor e agendar execuções de política que podem afetar a operação da instância do Mecanismo de Banco de Dados. Por exemplo, os usuários na função PolicyAdministratorRole podem criar uma política que pode impedir que a maioria dos objetos seja criada no Mecanismo de Banco de Dados. Devido a essa possível elevação de credenciais, a função PolicyAdministratorRole deve ser concedida somente a usuários confiáveis para controlar a configuração do Mecanismo de Banco de Dados.
Exemplos
O exemplo a seguir renomeia uma política nomeada Test Policy 1
para Test Policy 2
.
EXEC msdb.dbo.sp_syspolicy_rename_policy
@name = N'Test Policy 1',
@new_name = N'Test Policy 2';
GO