빠른 시작: Azure PowerShell을 사용하여 Azure Dedicated HSM 만들기

중요합니다

Azure Dedicated HSM은 사용 중지됩니다. Microsoft는 2028년 7월 31일까지 기존 전용 HSM 고객을 완전히 지원합니다. 새 고객 온보딩은 허용되지 않습니다. 자세한 내용 및 필요한 작업은 공식 Azure 업데이트를 참조하세요.

Azure Dedicated HSM 사용자인 경우 Azure Dedicated HSM에서 Managed HSM 또는 Azure Cloud HSM으로 마이그레이션을 참조하세요. 이제 Azure Cloud HSM 은 일반적으로 제공되며 Azure Dedicated HSM의 후속 제품입니다.

새 고객은 워크로드 요구 사항에 따라 Azure Cloud HSM, 관리형 HSM 또는 Azure Key Vault 등록해야 합니다. 지침은 올바른 Azure 키 관리 솔루션을 선택하는 방법을 참조하세요.

이 문서에서는 Az.DedicatedHsm PowerShell 모듈을 사용하여 Azure Dedicated HSM을 만드는 방법을 설명합니다.

요구 사항

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.

Azure PowerShell을 로컬로 사용하도록 선택한 경우:
- 최신 버전의 Az PowerShell 모듈을 설치합니다.
- Connect-AzAccount cmdlet을 사용하여 Azure 계정에 로그인합니다.
Azure Cloud Shell을 사용하도록 선택한 경우:
- 자세한 내용은 Azure Cloud Shell 개요를 참조하세요.

중요합니다

Az.DedicatedHsm PowerShell 모듈은 미리 보기로 제공되며 Install-Module cmdlet을 사용하여 별도로 설치해야 합니다. 이 PowerShell 모듈이 일반 공급되면 향후 Az PowerShell 모듈 릴리스의 일부가 되며 Azure Cloud Shell 내에서 기본적으로 사용할 수 있습니다.

Install-Module -Name Az.DedicatedHsm

여러 Azure 구독이 있는 경우 리소스를 청구해야 하는 적절한 구독을 선택합니다. Set-AzContext cmdlet을 사용하여 특정 구독을 선택합니다.
```
Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
```

구독에 등록하는 데 필요한 리소스 공급자 및 기능 플래그입니다. AzureDedicatedHsm 및 DedicatedHsmEnabled 기능을 등록한 다음 Microsoft.HardwareSecurityModules 공급자를 등록합니다. DedicatedHsmEnabled 기능이 등록되지 않은 경우 전용 HSM cmdlet은 InvalidResourceType 오류를 반환합니다.

Register-AzProviderFeature -ProviderNamespace Microsoft.HardwareSecurityModules -FeatureName AzureDedicatedHsm
Register-AzProviderFeature -ProviderNamespace Microsoft.HardwareSecurityModules -FeatureName DedicatedHsmEnabled
Register-AzResourceProvider -ProviderNamespace Microsoft.HardwareSecurityModules

기능 등록에는 몇 분 정도 걸릴 수 있습니다. 두 기능 모두 Registered의 RegistrationState로 표시되는지 확인한 후 계속 진행하세요.

Get-AzProviderFeature -ProviderNamespace Microsoft.HardwareSecurityModules -FeatureName AzureDedicatedHsm
Get-AzProviderFeature -ProviderNamespace Microsoft.HardwareSecurityModules -FeatureName DedicatedHsmEnabled

리소스 그룹 만들기

New-AzResourceGroup cmdlet을 사용하여 Azure 리소스 그룹을 만듭니다. 리소스 그룹은 Azure 리소스가 그룹으로 배포되고 관리되는 논리적 컨테이너입니다.

다음 예제에서는 지정된 이름과 지정된 위치에 리소스 그룹을 만듭니다.

New-AzResourceGroup -Name myRG -Location westus

네트워크 리소스 만들기

전용 HSM은 가상 네트워크의 서브넷에 삽입되고 가상 네트워크에 ExpressRoute 게이트웨이는 있어야 합니다. 게이트웨이가 없으면 디바이스를 가상 네트워크에 연결하는 동안 오류가 발생하여 만들기 작업이 실패합니다.

세 개의 서브넷이 있는 가상 네트워크를 만듭니다. 하나는 컴퓨팅 리소스용 서브넷이고, 하나는 HSM용으로 Microsoft.HardwareSecurityModules/dedicatedHSMs에 위임된 서브넷이며, 다른 하나는 ExpressRoute 게이트웨이에 필요한 GatewaySubnet 서브넷입니다. HSM 서브넷 이름은 가상 네트워크 이름과 달라야 합니다.

$del = New-AzDelegation -Name dhsmDelegation `
  -ServiceName 'Microsoft.HardwareSecurityModules/dedicatedHSMs'

$compute = New-AzVirtualNetworkSubnetConfig -Name compute `
  -AddressPrefix 10.2.0.0/24
$hsmNet = New-AzVirtualNetworkSubnetConfig -Name hsmsubnet `
  -AddressPrefix 10.2.1.0/24 -Delegation $del
$gwNet = New-AzVirtualNetworkSubnetConfig -Name GatewaySubnet `
  -AddressPrefix 10.2.255.0/26

$vnetParams = @{
  Name              = 'myhsm-vnet'
  ResourceGroupName = 'myRG'
  Location          = 'westus'
  AddressPrefix     = '10.2.0.0/16'
  Subnet            = $compute, $hsmNet, $gwNet
}
New-AzVirtualNetwork @vnetParams

ErGwScale SKU를 사용하여 ExpressRoute 게이트웨이를 만듭니다. Azure는 게이트웨이의 공용 IP 주소를 자동으로 할당하고 관리하므로 사용자가 공용 IP 리소스를 만들 필요가 없습니다.

$gwSubnet = Get-AzVirtualNetwork -Name myhsm-vnet -ResourceGroupName myRG |
  Get-AzVirtualNetworkSubnetConfig -Name GatewaySubnet
$ipc = New-AzVirtualNetworkGatewayIpConfig -Name default `
  -SubnetId $gwSubnet.Id

$gwParams = @{
  Name              = 'myergw'
  ResourceGroupName = 'myRG'
  Location          = 'westus'
  IpConfigurations  = $ipc
  GatewayType       = 'ExpressRoute'
  GatewaySku        = 'ErGwScale'
  MinScaleUnit      = 1
  MaxScaleUnit      = 1
}
New-AzVirtualNetworkGateway @gwParams -Force

게이트웨이를 배포하는 데 약 18분이 걸립니다.

전용 HSM 만들기

전용 HSM을 만들려면 New-AzDedicatedHsm cmdlet을 사용합니다. 다음 예제에서는 해당 서브넷의 주소 범위 내의 프라이빗 IP 주소를 사용하여 HSM 서브넷에 전용 HSM을 만듭니다.

$Params = @{
  Name  = 'myHSM'
  ResourceGroupName = 'myRG'
  Location = 'westus'
  Sku = 'SafeNet Luna Network HSM A790'
  StampId = 'stamp1'
  SubnetId = '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myRG/providers/Microsoft.Network/virtualNetworks/myhsm-vnet/subnets/hsmsubnet'
  NetworkInterface = @{PrivateIPAddress = '10.2.1.4'}
}
New-AzDedicatedHsm @Params

Name       Provisioning State SKU                           Location
----       ------------------ ---                           --------
myHSM      Succeeded          SafeNet Luna Network HSM A790 westus

HSM 만들기 작업을 완료하는 데 약 8분이 걸립니다.

전용 HSM 가져오기

기존 전용 HSM에 대한 정보를 검색하려면 Get-AzDedicatedHsm cmdlet을 사용합니다. 다음 예제에서는 지정된 전용 HSM을 가져옵니다.

Get-AzDedicatedHsm -Name myHSM -ResourceGroupName myRG

Name       Provisioning State SKU                           Location
----       ------------------ ---                           --------
myHSM      Succeeded          SafeNet Luna Network HSM A790 westus

Note

Azure 포털은 해당 리소스 그룹에 전용 HSM을 나열하지 않습니다. HSM이 있는지 확인하려면 Get-AzDedicatedHsm를 사용합니다.

전용 HSM 업데이트

전용 HSM을 업데이트하려면 Update-AzDedicatedHsm cmdlet을 사용합니다. 다음 예제에서는 전용 HSM의 태그를 업데이트합니다.

Update-AzDedicatedHsm -Name myHSM -ResourceGroupName myRG -Tag @{'key1' = '1'; 'key2' = 2; 'key3' = 3}

Name       Provisioning State SKU                           Location
----       ------------------ ---                           --------
myHSM      Succeeded          SafeNet Luna Network HSM A790 westus

자원을 정리하세요

주의

리소스 그룹을 삭제 하기 전에 전용 HSM을 제로화하고 삭제합니다. 리소스 그룹을 직접 삭제해도 HSM은 삭제되지 않습니다. HSM이 고아 상태가 되어 요금이 계속 발생합니다. 자세한 내용은 HSM 리소스를 삭제하는 방법을 참조하세요.

전용 HSM 제거

HSM을 초기화한 후 Remove-AzDedicatedHsm cmdlet을 사용하여 제거합니다. 다음 예제에서는 지정된 전용 HSM을 삭제합니다.

Remove-AzDedicatedHsm -Name myHSM -ResourceGroupName myRG

Tip

만들기 작업이 실패하면 삭제 작업이 몇 시간 동안 Deleting 상태로 유지될 수 있습니다. 그럴 경우 Remove-AzDedicatedHsm cmdlet를 다시 실행하여 즉시 삭제를 완료합니다.

리소스 그룹 삭제

주의

다음 예제에서는 지정된 리소스 그룹 및 해당 그룹에 포함된 모든 리소스를 삭제합니다. 이 문서의 범위를 벗어난 리소스가 지정된 리소스 그룹에 있으면 해당 리소스도 삭제됩니다.

Remove-AzResourceGroup -Name myRG

다음 단계

Azure Dedicated HSM에 대해 자세히 알아봅니다.

피드백

이 페이지가 도움이 되었나요?

2026-10-08 에 마지막으로 업데이트됨