Sdílet prostřednictvím

Get-AzKeyVaultManagedHsm

  • Reference
Modul:
Az.KeyVault

Získejte spravované moduly HSM.

Syntaxe

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>]

Description

Rutina Get-AzKeyVaultManagedHsm získá informace o spravovaných modulech HSM v předplatném. Můžete zobrazit všechny instance spravovaných HSM v předplatném nebo filtrovat výsledky podle skupiny prostředků nebo konkrétního spravovaného HSM. Všimněte si, že i když je pro tuto rutinu zadání skupiny prostředků volitelné, když získáte jeden spravovaný HSM, měli byste to udělat pro lepší výkon.

Příklady

Příklad 1: Získání všech spravovaných HSM ve vašem aktuálním předplatném

Get-AzKeyVaultManagedHsm

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

Tento příkaz získá všechny spravované moduly HSM ve vašem aktuálním předplatném.

Příklad 2: Získání konkrétního spravovaného HSM

Get-AzKeyVaultManagedHsm -Name 'myhsm'

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

Tento příkaz získá spravovaný HSM s názvem myhsm ve vašem aktuálním předplatném.

Příklad 3: Získání spravovaných HSM ve skupině prostředků

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

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

Tento příkaz získá všechny spravované moduly HSM ve skupině prostředků myrg1.

Příklad 4: Získání spravovaných HSM pomocí filtrování

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

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

Tento příkaz získá všechny spravované moduly HSM v předplatném, které začínají na myhsm.

Příklad 5: Výpis odstraněných spravovaných hsM

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

Tento příkaz získá všechny odstraněné spravované HSM v aktuálním předplatném.

Parametry

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InRemovedState

Určuje, jestli se má ve výstupu zobrazit dříve odstraněný spravovaný fond HSM.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Umístění odstraněného spravovaného fondu HSM.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Název HSM. Rutina vytvoří plně kvalifikovaný název domény hsm na základě názvu a aktuálně vybraného prostředí.

Typ:String
Aliasy:HsmName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-ResourceGroupName

Určuje název skupiny prostředků přidružené k dotazovanému spravovanému HSM.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-SubscriptionId

ID předplatného. Ve výchozím nastavení se rutiny spouští v předplatném, které je nastavené v aktuálním kontextu. Pokud uživatel určí jiné předplatné, spustí se aktuální rutina v předplatném určeném uživatelem. Přepsání předplatných se projeví jenom během životního cyklu aktuální rutiny. Nezmění předplatné v kontextu a nemá vliv na následné rutiny.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Určuje klíč a volitelnou hodnotu zadané značky pro filtrování seznamu spravovaných hsM podle.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

Hashtable

Výstupy

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem