Partilhar via

  • Artigo

sp_syspolicy_rename_policy (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de 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 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= ] '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 de sistema msdb.

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

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 políticas 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 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 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 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