Delen via

Get-AzKeyVaultManagedHsm

  • Referentie
Module:
Az.KeyVault

Beheerde HSM's ophalen.

Syntax

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

De cmdlet Get-AzKeyVaultManagedHsm haalt informatie op over de beheerde HSM's in een abonnement. U kunt alle beheerde HSM-exemplaren in een abonnement bekijken of uw resultaten filteren op een resourcegroep of een bepaalde beheerde HSM. Hoewel het opgeven van de resourcegroep optioneel is voor deze cmdlet wanneer u één beheerde HSM krijgt, moet u dit doen voor betere prestaties.

Voorbeelden

Voorbeeld 1: Alle beheerde HSM's in uw huidige abonnement ophalen

Get-AzKeyVaultManagedHsm

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

Met deze opdracht worden alle beheerde HSM's in uw huidige abonnement opgehaald.

Voorbeeld 2: Een specifieke beheerde HSM ophalen

Get-AzKeyVaultManagedHsm -Name 'myhsm'

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

Met deze opdracht wordt de beheerde HSM met de naam myhsm opgehaald in uw huidige abonnement.

Voorbeeld 3: Beheerde HSM's ophalen in een resourcegroep

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

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

Met deze opdracht worden alle beheerde HSM's in de resourcegroep myrg1 opgeslagen.

Voorbeeld 4: Beheerde HSM's ophalen met behulp van filteren

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

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

Met deze opdracht worden alle beheerde HSM's opgehaald in het abonnement dat begint met 'myhsm'.

Voorbeeld 5: Verwijderde beheerde HSM's vermelden

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

Met deze opdracht worden alle verwijderde beheerde HSM's in het huidige abonnement opgehaald.

Parameters

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-InRemovedState

Hiermee geeft u op of de eerder verwijderde beheerde HSM-pool in de uitvoer moet worden weergegeven.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

De locatie van de verwijderde beheerde HSM-pool.

Type:String
Position:1
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

HSM-naam. Cmdlet bouwt de FQDN van een HSM op basis van de naam en momenteel geselecteerde omgeving.

Type:String
Aliases:HsmName
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:True

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep die is gekoppeld aan de beheerde HSM die wordt opgevraagd.

Type:String
Position:1
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:True

-SubscriptionId

De id van het abonnement. Cmdlets worden standaard uitgevoerd in het abonnement dat is ingesteld in de huidige context. Als de gebruiker een ander abonnement opgeeft, wordt de huidige cmdlet uitgevoerd in het abonnement dat door de gebruiker is opgegeven. Het overschrijven van abonnementen wordt alleen van kracht tijdens de levenscyclus van de huidige cmdlet. Het abonnement wordt niet gewijzigd in de context en heeft geen invloed op volgende cmdlets.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Hiermee geeft u de sleutel en optionele waarde van de opgegeven tag op om de lijst met beheerde HSM's te filteren op.

Type:Hashtable
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem