sp_syspolicy_rename_policy_category (Transact-SQL)

Renomeia uma categoria de 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_category { [ @name = ] 'name' | [ @policy_category_id = ] policy_category_id }
    , [ @new_name = ] 'new_name'

Argumentos

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

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

• [ @new_name= ] 'new_name'
  É o novo nome da categoria de 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_category no contexto do banco de dados do sistema msdb.

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

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 categoria de política chamada 'Test Category 1' para 'Test Category 2'.

EXEC msdb.dbo.sp_syspolicy_rename_policy_category @name = N'Test Category 1'
, @new_name = N'Test Category 2';

GO

Consulte também

Referência

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

sp_syspolicy_add_policy_category (Transact-SQL)

sp_syspolicy_delete_policy_category (Transact-SQL)

sp_syspolicy_update_policy_category (Transact-SQL)