Share via


sp_syspolicy_rename_policy_category (Transact-SQL)

Renomeia uma categoria de diretiva existente no Gerenciamento Baseado em Diretiva.

Ícone de vínculo de tópicoConvenções de 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 da diretiva 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 diretiva que você deseja renomear. policy_category_id é int e deve ser especificado se name for NULL.

  • [ @new_name= ] 'new_name'
    É o novo nome da categoria de diretiva. new_name é sysnamee é 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 de sistema msdb.

Você deve especificar um valor para name ou policy_category_id. Ambos não podem ser NULL. Para obter estes valores, consulte a exibição do sistema msdb.dbo.syspolicy_policy_categories.

Permissões

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

Observação sobre segurançaObservação sobre segurança

Possível elevação de credenciais: os usuários na função PolicyAdministratorRole podem criar gatilhos de servidor e agendar execuções de diretivas que possam 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 diretiva 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 somente aos 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 diretiva 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