Condividi tramite

Get-AzureRole

  • Riferimento
Modulo:
Azure

Restituisce un elenco di ruoli nel servizio Microsoft Azure.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Get-AzureRole restituisce un oggetto elenco con i dettagli sui ruoli nel servizio Microsoft Azure. Se si specifica il parametro RoleName , Get-AzureRole restituisce i dettagli solo su tale ruolo. Se si specifica il parametro InstanceDetails , vengono restituiti dettagli aggiuntivi specifici dell'istanza.

Esempio

Esempio 1: Ottenere un elenco di ruoli per un servizio

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

Questo comando restituisce un oggetto con i dettagli su tutti i ruoli di produzione in esecuzione nel servizio MySvc01.

Esempio 2: Ottenere dettagli su un ruolo in esecuzione in un servizio

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

Questo comando restituisce un oggetto con i dettagli sul ruolo MyTestVM3, in esecuzione nell'ambiente di gestione temporanea del servizio MySvc01.

Esempio 3: Ottenere informazioni sull'istanza di istanze di un ruolo in esecuzione in un servizio

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

Questo comando restituisce un oggetto con i dettagli sulle istanze del ruolo MyTestVM02 in esecuzione nell'ambiente di produzione nel servizio MySvc01.

Esempio 4: Ottenere una tabella delle istanze del ruolo associate a un servizio

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

Questo comando restituisce una tabella del nome dell'istanza, delle dimensioni e dello stato di tutte le istanze del ruolo in esecuzione nell'ambiente di produzione nel servizio MySvc01.

Parametri

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InstanceDetails

Specifica che questo cmdlet restituisce informazioni dettagliate sulle istanze di ogni ruolo.

Tipo:SwitchParameter
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RoleName

Specifica il nome del ruolo da ottenere.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceName

Specifica il nome del servizio di Azure.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Slot

Specifica l'ambiente di distribuzione di Azure. I valori accettabili per questo parametro sono: Produzione o Gestione temporanea.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False