Unregister-ServiceFabricApplicationType

  • Referência
Módulo:
ServiceFabric

Cancela o registro de um tipo de aplicativo do Service Fabric.

Sintaxe

Unregister-ServiceFabricApplicationType
          [-ApplicationTypeName] <String>
          [-ApplicationTypeVersion] <String>
          [-Async]
          [-Force]
          [-TimeoutSec <Int32>]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

O cmdlet Unregister-ServiceFabricApplicationType cancela o registro de um tipo de aplicativo do Service Fabric. O tipo de aplicativo deve ter sido registrado anteriormente com Register-ServiceFabricApplicationType.

Antes de cancelar o registro de um tipo de aplicativo, você deve usar o cmdlet Remove-ServiceFabricService para remover os serviços baseados no aplicativo. Use o cmdlet Remove-ServiceFabricApplication para remover instâncias do tipo de aplicativo. Se você cancelar o registro de um tipo de aplicativo, o pacote do aplicativo será removido do armazenamento de imagens.

Para gerenciar clusters do Service Fabric, inicie o Windows PowerShell usando a opção Executar como administrador. 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: Cancelar o registro de um tipo de aplicativo

PS C:\> Unregister-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0" -Force

Este comando cancela o registro do tipo de aplicativo CalcServiceApp com a versão 1.0. Quando o comando retorna bem-sucedido, o tipo de aplicativo foi cancelado com êxito. Como o comando inclui o parâmetro Force, o cmdlet não solicita confirmação.

Exemplo 2: Cancelar o registro de um tipo de aplicativo assíncrono

PS C:\> Unregister-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0" -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0"

Unregister-ServiceFabricApplicationType inicia o desprovisionamento do tipo de aplicativo CalcServiceApp com a versão 1.0. Como a opção -Async é fornecida, o comando retorna assim que o cluster recebe a solicitação. Get-ServiceFabricApplicationType obtém os tipos de aplicativo registrados no cluster com o filtro especificado. Os tipos de aplicativo retornados (se houver) incluem o status do registro. O cmdlet pode ser usado para ver o progresso da desprovisionação. Quando o tipo de aplicativo com a versão especificada é cancelado com êxito, ele não será mostrado na saída Get-ServiceFabricApplicationType do .

Parâmetros

-ApplicationTypeName

Especifica o nome de um tipo de aplicativo do Service Fabric. O cmdlet cancela o registro do tipo especificado.

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

-ApplicationTypeVersion

Especifica a versão de um tipo de aplicativo do Service Fabric. O cmdlet cancela o registro do tipo que tem a versão especificada.

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

-Async

O comando retorna assim que a solicitação de cancelamento de registro é aceita pelo cluster. Use o comando Get-ServiceFabricApplicationType para consultar o status da solicitação. Ao passar a opção assíncrona, não há necessidade de aumentar o -TimeoutSec para pacotes de aplicativos grandes.

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

-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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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.

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

Entradas

System.String

Saídas

System.Object