Bagikan melalui

Get-AzKeyVaultManagedHsm

  • Referensi
Modul:
Az.KeyVault

Dapatkan HSM terkelola.

Sintaks

Get-AzKeyVaultManagedHsm
   [[-Name] <String>]
   [[-ResourceGroupName] <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]
Get-AzKeyVaultManagedHsm
   [-Name] <String>
   [-Location] <String>
   [-InRemovedState]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]
Get-AzKeyVaultManagedHsm
   [-InRemovedState]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzKeyVaultManagedHsm mendapatkan informasi tentang HSM terkelola dalam langganan. Anda dapat melihat semua instans HSM terkelola dalam langganan, atau memfilter hasil Anda menurut grup sumber daya atau HSM terkelola tertentu. Perhatikan bahwa meskipun menentukan grup sumber daya bersifat opsional untuk cmdlet ini ketika Anda mendapatkan satu HSM terkelola, Anda harus melakukannya untuk performa yang lebih baik.

Contoh

Contoh 1: Dapatkan semua HSM terkelola di langganan Anda saat ini

Get-AzKeyVaultManagedHsm

Name    Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----    ------------------- -------- ---        ----------------- --------------------------------
myhsm   test-rg              eastus   StandardB1 Succeeded         Active

Perintah ini mendapatkan semua HSM terkelola dalam langganan Anda saat ini.

Contoh 2: Mendapatkan HSM terkelola tertentu

Get-AzKeyVaultManagedHsm -Name 'myhsm'

Name    Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----    ------------------- -------- ---        ----------------- --------------------------------
myhsm   test-rg              eastus   StandardB1 Succeeded         Active

Perintah ini mendapatkan HSM terkelola bernama myhsm dalam langganan Anda saat ini.

Contoh 3: Mendapatkan HSM terkelola dalam grup sumber daya

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

Name  Resource Group Name Location    SKU        ProvisioningState Security Domain ActivationStatus
----  ------------------- --------    ---        ----------------- --------------------------------
myhsm myrg1               eastus2euap StandardB1 Succeeded         Active

Perintah ini mendapatkan semua HSM terkelola dalam grup sumber daya bernama myrg1.

Contoh 4: Dapatkan HSM terkelola menggunakan pemfilteran

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

Name  Resource Group Name Location    SKU        ProvisioningState Security Domain ActivationStatus
----  ------------------- --------    ---        ----------------- --------------------------------
myhsm myrg1               eastus2euap StandardB1 Succeeded         Active

Perintah ini mendapatkan semua HSM terkelola dalam langganan yang dimulai dengan "myhsm".

Contoh 5: Mencantumkan HSM terkelola yang dihapus

Get-AzKeyVaultManagedHsm -InRemovedState

Name                     Location      DeletionDate           ScheduledPurgeDate    Purge Protection Enabled?
----                     --------      ------------           ------------------    -------------------------
xxxxxxxx-mhsm-4op2n2g4xe eastus2       12/30/2021 2:29:00 AM  3/30/2022 2:29:00 AM  True
xxxxxxx-mhsm-ertopo7tnxa westus        12/29/2021 11:48:42 PM 3/29/2022 11:48:42 PM True
xxxxxxx-mhsm-gg66fgctz67 westus        12/29/2021 11:48:42 PM 3/29/2022 11:48:42 PM False
xxxxxxx-mhsm-2m5jiop6mfo westcentralus 12/30/2021 12:26:14 AM 3/30/2022 12:26:14 AM True

Perintah ini mendapatkan semua HSM terkelola yang dihapus dalam langganan saat ini.

Parameter

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InRemovedState

Menentukan apakah akan menampilkan kumpulan HSM terkelola yang dihapus sebelumnya dalam output.

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

-Location

Lokasi kumpulan HSM terkelola yang dihapus.

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

-Name

Nama HSM. Cmdlet membangun FQDN HSM berdasarkan nama dan lingkungan yang saat ini dipilih.

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

-ResourceGroupName

Menentukan nama grup sumber daya yang terkait dengan HSM terkelola yang sedang dikueri.

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

-SubscriptionId

ID langganan. Secara default, cmdlet dijalankan dalam langganan yang diatur dalam konteks saat ini. Jika pengguna menentukan langganan lain, cmdlet saat ini dijalankan dalam langganan yang ditentukan oleh pengguna. Mengesampingkan langganan hanya berlaku selama siklus hidup cmdlet saat ini. Ini tidak mengubah langganan dalam konteks, dan tidak memengaruhi cmdlet berikutnya.

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

-Tag

Menentukan kunci dan nilai opsional tag yang ditentukan untuk memfilter daftar HSM terkelola.

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

Input

String

Hashtable

Output

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem