sp_syspolicy_rename_policy (Transact-SQL)

Renomeia uma política existente no Gerenciamento Baseado em Políticas.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual).

Convenções da sintaxe Transact-SQL

Sintaxe

sp_syspolicy_rename_policy { [ @name = ] 'name' | [ @policy_id = ] policy_id }
    , [ @new_name = ] 'new_name'

Argumentos

• [ @name= ] 'name'
  É o nome da política que você deseja renomear. name é sysname e deverá ser especificado se policy_id for NULL.

• [ @policy_id= ] policy_id
  É o identificador da política que você deseja renomear. policy_id é int e deverá ser especificado se name for NULL.

• [ @new_name= ] 'new_name'
  É o novo nome da política. new_name é sysname e é obrigatório. Não pode ser NULL ou uma cadeia de caracteres vazia.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

Você deve executar sp_syspolicy_rename_policy no contexto do banco de dados do sistema msdb.

Você deve especificar um valor para name ou policy_id. Nenhum deles pode ser NULL. Para obter esses valores, consulte a exibição do sistema msdb.dbo.syspolicy_policies.

Permissões

Exige a associação à função de banco de dados fixa PolicyAdministratorRole.

Observação sobre segurança

Possível elevação de credenciais: Os usuários na função PolicyAdministratorRole podem criar gatilhos de servidores e agendar execuções de políticas que podem afetar a operação da instância do Mecanismo de Banco de Dados.Por exemplo, os usuários da função PolicyAdministratorRole podem criar uma política que impeça a criação da maioria dos objetos no Mecanismo de Banco de Dados.Devido a essa possível elevação de credenciais, a função PolicyAdministratorRole deve ser concedida apenas a usuários que sejam confiáveis no controle da configuração do Mecanismo de Banco de Dados.

Exemplos

O exemplo seguinte renomeia uma política chamada '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

Consulte também

Referência

Procedimentos armazenados de Gerenciamento Baseado em Políticas (Transact-SQL)