Szybki start: tworzenie dedykowanego modułu HSM platformy Azure przy użyciu programu Azure PowerShell

Ważne

Dedykowany moduł HSM platformy Azure jest wycofywany. Firma Microsoft będzie w pełni obsługiwać istniejących klientów dedykowanego modułu HSM do 31 lipca 2028 r. Nie są akceptowane żadne nowe dołączania klientów. Aby uzyskać szczegółowe informacje i wymagane akcje, zobacz oficjalną aktualizację platformy Azure.

Jeśli jesteś użytkownikiem Azure Dedicated HSM, zobacz Migrowanie z Azure Dedicated HSM do Managed HSM lub Azure Cloud HSM. Moduł HSM w chmurze platformy Azure jest teraz ogólnie dostępny i następca dedykowanego modułu HSM platformy Azure.

Nowi klienci powinni ocenić i wdrożyć rozwiązanie Azure Cloud HSM, Managed HSM lub Azure Key Vault w zależności od wymagań dotyczących obciążeń. Aby uzyskać wskazówki, zobacz Jak wybrać odpowiednie rozwiązanie do zarządzania kluczami platformy Azure.

W tym artykule opisano sposób tworzenia dedykowanego modułu HSM platformy Azure przy użyciu modułu Az.DedicatedHsm programu PowerShell.

Requirements

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Jeśli zdecydujesz się używać programu Azure PowerShell lokalnie:
- Zainstaluj najnowszą wersję modułu Az programu PowerShell.
- Połącz się z kontem platformy Azure przy użyciu polecenia cmdlet Connect-AzAccount .
Jeśli zdecydujesz się używać usługi Azure Cloud Shell:
- Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cloud Shell .

Ważne

Chociaż moduł Az.DedicatedHsm programu PowerShell jest w wersji zapoznawczej, należy zainstalować go oddzielnie przy użyciu polecenia cmdlet Install-Module . Gdy ten moduł programu PowerShell stanie się ogólnie dostępny, będzie częścią przyszłych wydań modułu Az programu PowerShell i będzie domyślnie dostępny z poziomu usługi Azure Cloud Shell.

Install-Module -Name Az.DedicatedHsm

Jeśli masz wiele subskrypcji platformy Azure, wybierz odpowiednią subskrypcję, w której mają być rozliczane zasoby. Wybierz określoną subskrypcję przy użyciu polecenia cmdlet Set-AzContext .
```
Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
```

Wymagani dostawcy zasobów i flagi funkcji są zarejestrowani dla twojej subskrypcji. Zarejestruj funkcje AzureDedicatedHsm i DedicatedHsmEnabled , a następnie zarejestruj dostawcę Microsoft.HardwareSecurityModules . DedicatedHsmEnabled Jeśli funkcja nie jest zarejestrowana, dedykowane polecenia cmdlet modułu HSM zwracają błąd InvalidResourceType.

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

Rejestracja funkcji może potrwać kilka minut. Upewnij się, że obie funkcje pokazują wartość RegistrationState z Registered przed kontynuowaniem:

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

Tworzenie grupy zasobów

Utwórz grupę zasobów platformy Azure przy użyciu polecenia cmdlet New-AzResourceGroup . Grupa zasobów to logiczny kontener, w którym zasoby platformy Azure są wdrażane i zarządzane jako grupa.

Poniższy przykład tworzy grupę zasobów o określonej nazwie i w określonej lokalizacji.

New-AzResourceGroup -Name myRG -Location westus

Utwórz zasoby sieciowe

Dedykowany moduł HSM jest wstrzykiwany do podsieci w sieci wirtualnej, a sieć wirtualna musi mieć bramę usługi ExpressRoute. Bez bramy operacja tworzenia kończy się niepowodzeniem z powodu błędu podczas łączenia urządzenia z siecią wirtualną.

Utwórz sieć wirtualną z trzema podsieciami: jedną dla zasobów obliczeniowych, jedną delegowaną do Microsoft.HardwareSecurityModules/dedicatedHSMs dla modułu HSM oraz GatewaySubnet, której wymaga brama usługi ExpressRoute. Nazwa podsieci HSM musi być inna niż nazwa sieci wirtualnej.

$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

Utwórz bramę usługi ExpressRoute przy użyciu ErGwScale jednostki SKU. Azure automatycznie przypisuje publiczny adres IP bramy i zarządza nim, więc nie tworzysz zasobu publicznego adresu 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

Wdrożenie bramy trwa około 18 minut.

Utwórz dedykowany moduł HSM

Aby utworzyć dedykowany moduł HSM, należy użyć polecenia cmdlet New-AzDedicatedHsm . Poniższy przykład tworzy dedykowany moduł HSM w podsieci HSM z prywatnym adresem IP z zakresu adresów tej podsieci.

$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

Operacja tworzenia modułu HSM trwa około 8 minut.

Zdobądź dedykowany HSM

Aby pobrać informacje o istniejącym dedykowanym module HSM, użyj polecenia cmdlet Get-AzDedicatedHsm . Poniższy przykład pobiera określony dedykowany moduł HSM.

Get-AzDedicatedHsm -Name myHSM -ResourceGroupName myRG

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

Note

Portal Azure nie wyświetla dedykowanych modułów HSM w odpowiedniej grupie zasobów. Użyj polecenia Get-AzDedicatedHsm , aby potwierdzić, że moduł HSM istnieje.

Aktualizowanie dedykowanego modułu HSM

Aby zaktualizować dedykowany moduł HSM, należy użyć polecenia cmdlet Update-AzDedicatedHsm . Poniższy przykład aktualizuje tagi na dedykowanym module 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

Uprzątnij zasoby

Ostrzeżenie

Wyzeruj i usuń dedykowany moduł HSM przed usunięciem grupy zasobów. Usunięcie grupy zasobów bezpośrednio nie powoduje usunięcia modułu HSM. Umieszcza moduł HSM w stanie osieroconym, za który nadal naliczane są opłaty. Aby uzyskać więcej informacji, zobacz Jak usunąć zasób HSM.

Usuń dedykowany moduł HSM

Po wyzerowaniu modułu HSM użyj polecenia cmdlet Remove-AzDedicatedHsm, aby go usunąć. Przykład poniżej usuwa określony dedykowany moduł HSM.

Remove-AzDedicatedHsm -Name myHSM -ResourceGroupName myRG

Wskazówka

Jeśli operacja tworzenia nie powiedzie się, operacja usuwania może pozostać przez kilka godzin w stanie Deleting. Jeśli tak, uruchom ponownie polecenie cmdlet Remove-AzDedicatedHsm, aby natychmiast zakończyć usuwanie.

Usuwanie grupy zasobów

Ostrzeżenie

Poniższy przykład usuwa określoną grupę zasobów i wszystkie zawarte w niej zasoby. Jeśli zasoby spoza zakresu tego artykułu istnieją w określonej grupie zasobów, zostaną również usunięte.

Remove-AzResourceGroup -Name myRG

Dalsze kroki

Dowiedz się więcej o dedykowanym module HSM platformy Azure.

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-02