Get-AzKeyVaultManagedHsm

  • Referencia
Módulo:
Az.KeyVault

Obtenga los HSM administrados.

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

El cmdlet Get-AzKeyVaultManagedHsm obtiene información sobre los HSM administrados de una suscripción. Puede ver todas las instancias de HSM administradas en una suscripción o filtrar los resultados por un grupo de recursos o un HSM administrado determinado. Tenga en cuenta que, aunque especificar el grupo de recursos es opcional para este cmdlet cuando se obtiene un único HSM administrado, debe hacerlo para mejorar el rendimiento.

Ejemplos

Ejemplo 1: Obtención de todos los HSM administrados en la suscripción actual

Get-AzKeyVaultManagedHsm

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

Este comando obtiene todos los HSM administrados de la suscripción actual.

Ejemplo 2: Obtención de un HSM administrado específico

Get-AzKeyVaultManagedHsm -Name 'myhsm'

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

Este comando obtiene el HSM administrado denominado myhsm en la suscripción actual.

Ejemplo 3: Obtención de HSM administrados en un grupo de recursos

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

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

Este comando obtiene todos los HSM administrados del grupo de recursos denominado myrg1.

Ejemplo 4: Obtención de HSM administrados mediante el filtrado

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

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

Este comando obtiene todos los HSM administrados de la suscripción que comienzan por "myhsm".

Ejemplo 5: Enumerar HSM administrados eliminados

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

Este comando obtiene todos los HSM administrados eliminados en la suscripción actual.

Parámetros

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

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

-InRemovedState

Especifica si se debe mostrar el grupo de HSM administrado eliminado anteriormente en la salida.

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

-Location

Ubicación del grupo de HSM administrado eliminado.

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

-Name

Nombre de HSM. El cmdlet construye el FQDN de un HSM en función del nombre y del entorno seleccionado actualmente.

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

-ResourceGroupName

Especifica el nombre del grupo de recursos asociado al HSM administrado que se consulta.

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

-SubscriptionId

Identificador de la suscripción. De forma predeterminada, los cmdlets se ejecutan en la suscripción que se establece en el contexto actual. Si el usuario especifica otra suscripción, el cmdlet actual se ejecuta en la suscripción especificada por el usuario. La invalidación de suscripciones solo surte efecto durante el ciclo de vida del cmdlet actual. No cambia la suscripción en el contexto y no afecta a los cmdlets posteriores.

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

-Tag

Especifica la clave y el valor opcional de la etiqueta especificada para filtrar la lista de HSM administrados por.

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

Entradas

String

Hashtable

Salidas

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem