Compartir a través de

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 las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstanceDetails

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

Tipo:SwitchParameter
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

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

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RoleName

Especifica el nombre del rol que se va a obtener.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServiceName

Especifica el nombre del servicio de Azure.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Slot

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

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False