다음을 통해 공유


Get-AzKeyVaultManagedHsm

관리형 HSM을 가져옵니다.

구문

GetManagedHsm (기본값)

Get-AzKeyVaultManagedHsm
    [[-Name] <String>]
    [[-ResourceGroupName] <String>]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-SubscriptionId <String>]
    [<CommonParameters>]

GetDeletedManagedHsm

Get-AzKeyVaultManagedHsm
    [-Name] <String>
    [-Location] <String>
    [-InRemovedState]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-SubscriptionId <String>]
    [<CommonParameters>]

ListDeletedManagedHsms

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 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InRemovedState

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

GetDeletedManagedHsm
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ListDeletedManagedHsms
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Location

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

GetDeletedManagedHsm
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:True
DontShow:False
별칭:HsmName

매개 변수 집합

GetManagedHsm
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ResourceGroupName

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

GetManagedHsm
Position:1
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-SubscriptionId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Tag

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

매개 변수 속성

형식:Hashtable
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

Hashtable

출력

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem