Get-RoleInstance

Recupera informações sobre todas as instâncias de função que incluem pelo menos um ponto de extremidade.

Sintaxe

Get-RoleInstance –Role <string> [<CommonParameters>]

Get-RoleInstance –Current [<CommonParameters>]

Descrição

O cmdlet do Get-RoleInstance recupera informações sobre como executar instâncias de função.

Você pode executar o cmdlet sem parâmetros para recuperar informações de topologia sobre todas as instâncias de função em execução. Usando os parâmetros –role ou –current, você pode recuperar informações sobre instâncias de função específicas. Os objetos que são retornados por este cmdlet são objetos RoleInstance, de modo que todos os membros padrão da classe RoleInstance são acessíveis.

Parâmetros

-Current

Recupera informações sobre a instância de função atual.

-Role <string>

Recupera informações sobre a instância de função específica.

<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

Get-RoleInstance

Description
--------------
This command retrieves the details on all the known role instances in the deployment.

Exemplo 2

Get-RoleInstance -Current

Description
--------------
This command retrieves details on the current role instance.

Exemplo 3

Get-RoleInstance –Role WorkerRole1

Description
--------------
This command retrieves details on the instance for the specified role name.

Exemplo 4

Get-RoleInstance -role WorkerRole1 | select -expand InstanceEndpoints | %{$_.Value}

Description
------------- 
The objects returned by this cmdlet are RoleInstance objects, so all of the standard members are accessible. This command retrieves details about the input endpoints of the specified role.

Tópicos relacionados

Conceitos

Referência de cmdlet do PowerShell do Windows Azure

Outros recursos

Defining the Settings for an Application