Partilhar via


sp_syspolicy_rename_policy_category (Transact-SQL)

Aplica-se: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_syspolicy_rename_policy_category
    { [ @name = ] N'name' | [ @policy_category_id = ] policy_category_id }
    , [ @new_name = ] N'new_name'
[ ; ]

Argumentos

@name [ = ] N'nome'

O nome da categoria de política que você deseja renomear. @name é sysname e deve 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 deve ser especificado se @name for NULL.

@new_name [ = ] N'new_name'

O novo nome da categoria de 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_category no contexto do banco de dados do msdb sistema.

Você deve especificar um valor para @name ou @policy_category_id. Ambos não podem ser NULL. Para obter esses valores, consulte a exibição do msdb.dbo.syspolicy_policy_categories 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 categoria de política nomeada 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