Get-AzureRole

Referencia

Módulo:: Azure

Devuelve una lista de roles en el servicio de Microsoft Azure.

Nota

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de Azure Resource Manager.

Syntax

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

Description

El cmdlet Get-AzureRole devuelve un objeto de lista con detalles sobre los roles del servicio de Microsoft Azure. Si especifica el parámetro RoleName , Get-AzureRole solo devuelve detalles sobre ese rol. Si especifica el parámetro InstanceDetails , se devuelven detalles adicionales específicos de la instancia.

Ejemplos

Ejemplo 1: Obtener una lista de roles para un servicio

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

Este comando devuelve un objeto con detalles sobre todos los roles de producción que se ejecutan en el servicio MySvc01.

Ejemplo 2: Obtener detalles sobre un rol que se ejecuta en un servicio

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

Este comando devuelve un objeto con detalles sobre el rol MyTestVM3, que se ejecuta en el entorno de ensayo del servicio MySvc01.

Ejemplo 3: Obtención de información de instancia sobre instancias de un rol que se ejecuta en un servicio

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

Este comando devuelve un objeto con detalles sobre las instancias del rol MyTestVM02 que se ejecuta en el entorno de producción en el servicio MySvc01.

Ejemplo 4: Obtener una tabla de las instancias de rol asociadas a un servicio

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

Este comando devuelve una tabla del nombre, el tamaño y el estado de todas las instancias de rol que se ejecutan en el entorno de producción en el servicio MySvc01.

Parámetros

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

Continuar
Ignore
Inquire
SilentlyContinue
Stop
Suspender

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

-InformationVariable

Especifica una variable de información.

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

-InstanceDetails

Especifica que este cmdlet devuelve detalles sobre las instancias de cada rol.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-RoleName

Especifica el nombre del rol que se va a obtener.

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

-ServiceName

Especifica el nombre del servicio de Azure.

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

-Slot

Especifica el entorno de implementación de Azure. Los valores aceptables para este parámetro son: Producción o ensayo.

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

Set-AzureRole