Get-AzureRole

Referência

Módulo:: Azure

Retorna uma lista de funções em seu serviço do Microsoft Azure.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

Get-AzureRole
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-RoleName] <String>]
   [-InstanceDetails]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureRole retorna um objeto de lista com detalhes sobre as funções em seu serviço do Microsoft Azure. Se você especificar o parâmetro RoleName , Get-AzureRole retornará detalhes somente sobre essa função. Se você especificar o parâmetro InstanceDetails , detalhes adicionais específicos da instância serão retornados.

Exemplos

Exemplo 1: Obter uma lista de funções para um serviço

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production"

Esse comando retorna um objeto com detalhes sobre todas as funções de produção em execução no serviço MySvc01.

Exemplo 2: Obter detalhes sobre uma função em execução em um serviço

PS C:\> Get-AzureRole -ServiceName "MySvc1" -Slot "Staging" -RoleName "MyTestVM3"

Esse comando retorna um objeto com detalhes sobre a função MyTestVM3, em execução no ambiente de preparo do serviço MySvc01.

Exemplo 3: Obter informações de instância sobre instâncias de uma função em execução em um serviço

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestVM02" -InstanceDetails

Esse comando retorna um objeto com detalhes sobre as instâncias da função MyTestVM02 em execução no ambiente de produção no serviço MySvc01.

Exemplo 4: Obter uma tabela das instâncias de função associadas a um serviço

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -InstanceDetails | Format-Table -Auto "InstanceName", "InstanceSize", "InstanceStatus"

Esse comando retorna uma tabela do nome da instância, tamanho e status de todas as instâncias de função em execução no ambiente de produção no serviço MySvc01.

Parâmetros

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

Continuar
Ignorar
Perguntar
SilentlyContinue
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica uma variável de informação.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceDetails

Especifica que esse cmdlet retorna detalhes sobre as instâncias em cada função.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleName

Especifica o nome da função a ser obtida.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

Especifica o nome do serviço do Azure.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Slot

Especifica o ambiente de implantação do Azure. Os valores aceitáveis para esse parâmetro são: Produção ou Preparo.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Set-AzureRole