Partilhar via


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