Get-AzKeyVaultManagedHsm

Ottenere moduli di protezione hardware gestiti.

Sintassi

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

Descrizione

Il cmdlet Get-AzKeyVaultManagedHsm ottiene informazioni sui moduli di protezione hardware gestiti in una sottoscrizione. È possibile visualizzare tutte le istanze di moduli di protezione hardware gestiti in una sottoscrizione oppure filtrare i risultati in base a un gruppo di risorse o a un modulo di protezione hardware gestito specifico. Si noti che anche se specificare il gruppo di risorse è facoltativo per questo cmdlet quando si ottiene un singolo modulo di protezione hardware gestito, è consigliabile farlo per ottenere prestazioni migliori.

Esempio

Esempio 1: Ottenere tutti i moduli di protezione hardware gestiti nella sottoscrizione corrente

Get-AzKeyVaultManagedHsm

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

Questo comando ottiene tutti i moduli di protezione hardware gestiti nella sottoscrizione corrente.

Esempio 2: Ottenere un modulo di protezione hardware gestito specifico

Get-AzKeyVaultManagedHsm -Name 'myhsm'

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

Questo comando ottiene il modulo di protezione hardware gestito denominato myhsm nella sottoscrizione corrente.

Esempio 3: Ottenere moduli di protezione hardware gestiti in un gruppo di risorse

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

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

Questo comando ottiene tutti i moduli di protezione hardware gestiti nel gruppo di risorse denominato myrg1.

Esempio 4: Ottenere moduli di protezione hardware gestiti usando il filtro

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

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

Questo comando ottiene tutti i moduli di protezione hardware gestiti nella sottoscrizione che iniziano con "myhsm".

Esempio 5: Elencare i moduli di protezione hardware gestiti eliminati

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

Questo comando ottiene tutti i moduli di protezione hardware gestiti eliminati nella sottoscrizione corrente.

Parametri

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InRemovedState

Specifica se visualizzare il pool di moduli di protezione hardware gestito eliminato in precedenza nell'output.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

Percorso del pool di moduli di protezione hardware gestito eliminato.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nome HSM. Il cmdlet costruisce il nome di dominio completo di un modulo di protezione hardware in base al nome e all'ambiente attualmente selezionato.

Type:String
Aliases:HsmName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-ResourceGroupName

Specifica il nome del gruppo di risorse associato al modulo di protezione hardware gestito sottoposto a query.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-SubscriptionId

ID della sottoscrizione. Per impostazione predefinita, i cmdlet vengono eseguiti nella sottoscrizione impostata nel contesto corrente. Se l'utente specifica un'altra sottoscrizione, il cmdlet corrente viene eseguito nella sottoscrizione specificata dall'utente. L'override delle sottoscrizioni ha effetto solo durante il ciclo di vita del cmdlet corrente. Non modifica la sottoscrizione nel contesto e non influisce sui cmdlet successivi.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Specifica la chiave e il valore facoltativo del tag specificato per filtrare l'elenco di moduli di protezione hardware gestiti in base a .

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Hashtable

Output

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem