Bagikan melalui

Get-AzureRole

  • Referensi
Modul:
Azure

Mengembalikan daftar peran dalam layanan Microsoft Azure Anda.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.

Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.

Sintaks

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

Deskripsi

Cmdlet Get-AzureRole mengembalikan objek daftar dengan detail tentang peran di layanan Microsoft Azure Anda. Jika Anda menentukan parameter RoleName, Get-AzureRole mengembalikan detail pada peran tersebut saja. Jika Anda menentukan parameter InstanceDetails, detail tambahan khusus instans akan dikembalikan.

Contoh

Contoh 1: Mendapatkan daftar peran untuk layanan

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

Perintah ini mengembalikan objek dengan detail tentang semua peran produksi yang berjalan pada layanan MySvc01.

Contoh 2: Mendapatkan detail tentang peran yang berjalan pada layanan

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

Perintah ini mengembalikan objek dengan detail tentang peran MyTestVM3, berjalan pada lingkungan penahapan layanan MySvc01.

Contoh 3: Mendapatkan informasi instans tentang instans peran yang berjalan pada layanan

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

Perintah ini mengembalikan objek dengan detail tentang instans peran MyTestVM02 yang berjalan di lingkungan produksi pada layanan MySvc01.

Contoh 4: Mendapatkan tabel instans peran yang terkait dengan layanan

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

Perintah ini mengembalikan tabel nama instans, ukuran, dan status semua instans peran yang berjalan di lingkungan produksi pada layanan MySvc01.

Parameter

-InformationAction

Menentukan bagaimana cmdlet ini merespons peristiwa informasi.

Nilai yang dapat diterima untuk parameter ini adalah:

  • Lanjutkan
  • Abaikan
  • Tanya
  • Lanjutkan Diam-diam
  • Stop
  • Tangguhkan
Jenis:ActionPreference
Alias:infa
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InformationVariable

Menentukan variabel informasi.

Jenis:String
Alias:iv
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InstanceDetails

Menentukan bahwa cmdlet ini mengembalikan detail tentang instans pada setiap peran.

Jenis:SwitchParameter
Position:3
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Profile

Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.

Jenis:AzureSMProfile
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-RoleName

Menentukan nama peran yang akan didapatkan.

Jenis:String
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ServiceName

Menentukan nama layanan Azure.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Slot

Menentukan lingkungan penyebaran Azure. Nilai yang dapat diterima untuk parameter ini adalah: Produksi atau Penahapan.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False