Remove-ServiceFabricService

  • Referência
Módulo:
ServiceFabric

Remove um serviço existente do Service Fabric.

Sintaxe

Remove-ServiceFabricService
      [-ServiceName] <Uri>
      [-Force]
      [-ForceRemove]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-ServiceFabricService remove um serviço existente do Service Fabric. Um serviço deve estar em execução antes que você possa removê-lo.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.

Exemplos

Exemplo 1: Remover uma malha de serviço

PS C:\> Remove-ServiceFabricService -ServiceName fabric:/myapp/persistenttodolist/svc1 -Force

Este comando remove o serviço Service Fabric especificado. Como o comando inclui o parâmetro Force, o cmdlet não solicita confirmação.

Exemplo 2: ForceRemove um serviço de malha de serviço com Confirmação

PS C:\> Remove-ServiceFabricService -ServiceName fabric:/myapp/persistenttodolist/svc1 -Confirm -ForceRemove

Essa força de comando remove o serviço do Service Fabric especificado. Como o comando inclui o parâmetro Confirm, o cmdlet solicitará que você confirme se é o nome de serviço pretendido no qual você deseja executar a operação. Após a confirmação, o serviço é removido de forma irregular devido ao parâmetro ForceRemove.

Exemplo 3: ForceRemove um serviço de malha de serviço com tempo limite

PS C:\> Remove-ServiceFabricService -ServiceName fabric:/myapp/persistenttodolist/svc1 -TimeoutSec 10 -ForceRemove

Essa força de comando remove o serviço Service Fabric especificado. Como o comando inclui o parâmetro Timeout, a operação atingirá o tempo limite se não puder ser concluída no tempo especificado.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário. O Powershell não pedirá a confirmação do usuário para executar o comando.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ForceRemove

Indica que esse comando força a remoção do serviço Service Fabric. Isso deve ser usado somente se a remoção do serviço estiver fora do prazo. Por exemplo: se Remove-ServiceFabricService estiver com o tempo limite esgotado e as réplicas do serviço ainda estiverem presentes, isso significa que o serviço está preso em ChangeRole/Close e a sequência de desligamento não pode ser concluída. Ao usar ForceRemove, ignoramos a sequência de desligamento do serviço e o serviço é removido sem graça. Para o serviço com monitoração de estado, seu estado persistente não seria limpo. Para verificar se as réplicas estão presentes, use Get-ServiceFabricReplica.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServiceName

Especifica o URI (Uniform Resource Identifier) de um serviço do Service Fabric.

Tipo:Uri
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado e nenhuma alteração permanente é feita.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

System.Uri

Saídas

System.Object