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
Aliases:infa
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Aliases:iv
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceDetails

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

Tipo:SwitchParameter
Position:3
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters: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
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleName

Specifica il nome del ruolo da ottenere.

Tipo:String
Position:2
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Specifica il nome del servizio di Azure.

Tipo:String
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-Slot

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

Tipo:String
Position:1
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False