Share via

Get-AzKeyVaultManagedHsm

  • 참조
모듈:
Az.KeyVault

관리형 HSM을 가져옵니다.

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

Get-AzKeyVaultManagedHsm cmdlet은 구독에서 관리되는 HSM에 대한 정보를 가져옵니다. 구독에서 모든 관리형 HSM 인스턴스를 보거나 리소스 그룹 또는 특정 관리형 HSM별로 결과를 필터링할 수 있습니다. 단일 관리형 HSM을 가져올 때 이 cmdlet에 리소스 그룹을 지정하는 것은 선택 사항이지만 성능을 향상시키려면 그렇게 해야 합니다.

예제

예제 1: 현재 구독에서 관리되는 모든 HSM 가져오기

Get-AzKeyVaultManagedHsm

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

이 명령은 현재 구독의 모든 관리형 HSM을 가져옵니다.

예제 2: 특정 관리형 HSM 가져오기

Get-AzKeyVaultManagedHsm -Name 'myhsm'

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

이 명령은 현재 구독에서 myhsm이라는 관리형 HSM을 가져옵니다.

예제 3: 리소스 그룹에서 관리형 HSM 가져오기

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

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

이 명령은 myrg1이라는 리소스 그룹의 모든 관리형 HSM을 가져옵니다.

예제 4: 필터링을 사용하여 관리형 HSM 가져오기

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

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

이 명령은 "myhsm"으로 시작하는 구독의 모든 관리형 HSM을 가져옵니다.

예제 5: 삭제된 관리형 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

이 명령은 현재 구독에서 삭제된 관리형 HSM을 모두 가져옵니다.

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-InRemovedState

이전에 삭제된 관리형 HSM 풀을 출력에 표시할지 여부를 지정합니다.

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

-Location

삭제된 관리형 HSM 풀의 위치입니다.

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

-Name

HSM 이름입니다. Cmdlet은 이름 및 현재 선택된 환경에 따라 HSM의 FQDN을 생성합니다.

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

-ResourceGroupName

쿼리할 관리형 HSM과 연결된 리소스 그룹의 이름을 지정합니다.

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

-SubscriptionId

구독의 ID입니다. 기본적으로 cmdlet은 현재 컨텍스트에서 설정된 구독에서 실행됩니다. 사용자가 다른 구독을 지정하면 현재 cmdlet이 사용자가 지정한 구독에서 실행됩니다. 구독 재정의는 현재 cmdlet의 수명 주기 동안에만 적용됩니다. 컨텍스트에서 구독을 변경하지 않으며 후속 cmdlet에는 영향을 주지 않습니다.

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

-Tag

관리되는 HSM 목록을 필터링할 지정된 태그의 키 및 선택적 값을 지정합니다.

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

입력

String

Hashtable

출력

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem