Excluir um aplicativo de serviço no SharePoint Server
APLICA-SE A:2013 2016 2019 Subscription Edition SharePoint no Microsoft 365
É possível excluir um aplicativo de serviço SharePoint Server usando site da Administração Central do SharePoint ou os cmdlets do Microsoft PowerShell.
Cuidado
A ação de exclusão de um aplicativo de serviço é permanente: não é possível desfazer essa operação.
Antes de excluir um aplicativo de serviço, verifique se sua remoção não afetará negativamente os usuários. Recomendamos que verifique se algum aplicativo Web está consumindo atualmente o aplicativo de serviço que você excluirá. Para saber mais sobre como desconectar um aplicativo de serviço de um aplicativo Web, confira Adicionar ou remover conexões de aplicativo de serviço de um aplicativo Web no SharePoint Server.
Ao excluir um aplicativo de serviço, você tem a opção de excluir também o banco de dados do aplicativo de serviço. Alguns aplicativos de serviço não possuem bancos de dados. Se você planeja criar o aplicativo de serviço novamente no futuro, não exclua o banco de dados do aplicativo de serviço. Se o aplicativo de serviço for temporário, provavelmente você vai querer excluir o banco de dados durante essa operação.
Para garantir que o aplicativo de serviço está disponível para um possível uso futuro, considere fazer backup do aplicativo de serviço antes de exclui-lo. Para obter mais informações, consulte Backup dos aplicativos de serviço no SharePoint Server e Restaurar aplicativos de serviço no SharePoint Server.
Para excluir um aplicativo de serviço usando a Administração Central
Verifique se a conta de usuário que está executando esse procedimento é membro do grupo Administradores de Farm do SharePoint.
No site da Administração Central do SharePoint, clique em Gerenciamento de Aplicativo e em Gerenciar aplicativos de serviço.
Na página Gerenciar Aplicativos de Serviço, clique na linha que contém o aplicativo de serviço que você deseja excluir. A faixa de opções fica disponível.
Na faixa de opções, clique em Excluir.
Na caixa de diálogo de confirmação, selecione a caixa de verificação junto a Eliminar dados associados às Aplicações de Serviço se quiser eliminar a base de dados da aplicação de serviço. Se você quiser reter o banco de dados, desmarque essa caixa de seleção.
Clique em OK para excluir o aplicativo de serviço ou clique em Cancelar para interromper a operação.
Para excluir um aplicativo de serviço usando o PowerShell
Verifique se você cumpre os requisitos mínimos a seguir:
Você deve ser membro da função de servidor fixo no securityadmin na instância do SQL Server
Você deve ser membro na função de banco de dado fixo no db_owner em todos os bancos de dados que devam ser atualizados.
Você deve ser um membro do grupo de Administradores no servidor no qual você está executando o cmdlet PowerShell.
Observação
Se as permissões não forem satisfeitas, entre em contato com seu Administrador da instalação ou com o administrador do SQL Server para solicitar essas permissões.
Para mais informações sobre as permissões do PowerShell, consulte Permissões e Add-SPShellAdmin
Inicie o Shell de Gerenciamento do SharePoint.
No prompt de comando PowerShell, digite os seguintes comandos.
Para recuperar o aplicativo de serviço que você deseja excluir, digite o seguinte comando:
$spapp = Get-SPServiceApplication -Name "<Service application display name>"
Em que <Nome> a apresentar da aplicação de serviço é o nome a apresentar da aplicação de serviço que pretende eliminar.
As informações do aplicativo de serviço serão restauradas na variável $spapp.
Importante
Você precisa digitar o nome de exibição com aspas, e precisa digitar o nome de exibição exato do aplicativo de serviço. Isso inclui a capitalização. Recomendamos que você não crie múltiplos aplicativos de serviço com o mesmo nome de exibição. Se você tiver essa situação, poderá usar o cmdlet Get-SPServiceApplication para listar todos os aplicativos de serviço. Em seguida, é possível usar o GUID do aplicativo de serviço e o parâmetro -Identity para especificar o aplicativo de serviço que você deseja excluir. Para saber mais, confira Get-SPServiceApplication.
Para excluir o aplicativo de serviço selecionado, execute um dos seguintes comandos. em ambos os casos, você recebe uma solicitação de confirmação da exclusão.
- Para excluir o aplicativo de serviço selecionado sem remover o banco de dados do aplicativo de serviço, digite o seguinte comando:
Remove-SPServiceApplication $spapp
- Para excluir o aplicativo de serviço selecionado e também excluir o banco de dados do aplicativo de serviço, digite o seguinte comando:
Remove-SPServiceApplication $spapp -RemoveData
Exemplo
$spapp = Get-SPServiceApplication -Name "Contoso BDC Service"
Remove-SPServiceApplication $spapp -RemoveData
Nesse exemplo, as informações do aplicativo de serviço "Contoso BDC Service" são armazenadas na variável $spapp. Após a ação ser confirmada, o aplicativo de serviço e seu banco de dados são permanentemente excluídos.
Para saber mais, confira Get-SPServiceApplication e Remove-SPServiceApplication.