Condividi tramite

Get-AzKeyVaultManagedHsm

  • Riferimento
Modulo:
Az.KeyVault

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

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InRemovedState

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Percorso del pool di moduli di protezione hardware gestito eliminato.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:String
Alias:HsmName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-ResourceGroupName

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

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 .

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

Hashtable

Output

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem