Share via


Set-RoleInstanceStatus

Remova a instância do serviço para facilitar a depuração. Quando a instância é definida como ocupada usando este cmdlet, a instância não é considerada pelo balanceador de carga.

Sintaxe

Set-RoleInstanceStatus –Busy [<CommonParameters>]

Set-RoleInstanceStatus –Ready [<CommonParameters>]

Descrição

O cmdlet RoleInstanceStatus-Fixo remove uma instância de função do balanceador de carga com o parâmetro –Busy ou adiciona-o de volta ao balanceador de carga com o parâmetro –Ready.

Quando você executar este cmdlet, verá o seguinte aviso:

AVISO: O status de instância de função definido com Set-RoleInstanceStatus só permanecerá aplicado para a duração da sessão do PowerShell na qual o cmdlet foi executado.

Se você fechar a janela do PowerShell, a instância de função voltará ao estado Pronto se nenhum outro processo estiver fazendo a instância de função ficar Ocupado. Além disso, o status da instância de função não é atualizado até da próxima vez que o evento RoleEnvironment.StatusCheck for gerado. Depois de terminar de depurar, a instância de função precisa ser retornada para o serviço. Para fazer isto, você pode fechar a sessão do PowerShell ou usar o parâmetro –Ready.

Parâmetros

-Busy

Define o status da instância de função atual como ocupado.

Obrigatório?

true

Posição?

named

Valor padrão

Nenhum

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

-Ready

Define o status da instância de função atual como pronto.

Obrigatório?

true

Posição?

named

Valor padrão

Nenhum

Aceitar entrada de pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

<CommonParameters>

Este cmdlet dá suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable e –OutVariable. Para obter mais informações, consulte about_CommonParameters

Exemplo 1

Set-RoleInstanceStatus -Busy

Description
--------------
This command sets the status of the current role instance to busy, which enables you to debug issues or make updates without the interference of external activity.

Exemplo 2

Set-RoleInstanceStatus -Ready

Description
--------------
This command sets the status of the current role instance to ready, which makes the role instance available for external activity.

Tópicos relacionados

Conceitos

Referência de cmdlet do PowerShell do Windows Azure

Outros recursos

Defining the Settings for an Application