Delen via


New-AzKeyVaultManagedHsm

Hiermee maakt u een beheerde HSM.

Syntax

Default (Standaard)

New-AzKeyVaultManagedHsm
    [-Name] <String>
    [-ResourceGroupName] <String>
    [-Location] <String>
    [-Administrator] <String[]>
    [-Sku <String>]
    -SoftDeleteRetentionInDays <Int32>
    [-PublicNetworkAccess <String>]
    [-EnablePurgeProtection]
    [-UserAssignedIdentity <String[]>]
    [-Tag <Hashtable>]
    [-NetworkRuleSet <PSManagedHsmNetworkRuleSet>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Description

De cmdlet New-AzKeyVaultManagedHsm maakt een beheerde HSM in de opgegeven resourcegroep. De gebruiker moet het volgende doen om sleutels toe te voegen, te verwijderen of weer te geven in de beheerde HSM:

  1. machtigingen verlenen door gebruikers-id toe te voegen aan beheerder;
  2. roltoewijzing toevoegen voor gebruiker zoals "Beheerde HSM Crypto User" enzovoort;
  3. een back-up maken van beveiligingsdomeingegevens van een beheerde HSM met behulp van Export-AzKeyVaultSecurityDomain.

Voorbeelden

Voorbeeld 1: Een door StandardB1 beheerde HSM maken

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -SoftDeleteRetentionInDays 70
Name  Resource Group Name Location    SKU
----  ------------------- --------    ---
myhsm myrg1               eastus2euap StandardB1

Met deze opdracht maakt u een beheerde HSM met de naam myhsm op de locatie eastus2euap. Met de opdracht wordt de beheerde HSM toegevoegd aan de resourcegroep met de naam myrg1. Omdat de opdracht geen waarde voor de SKU-parameter opgeeft, wordt er een Standard_B1 beheerde HSM gemaakt.

Voorbeeld 2: Een door CustomB32 beheerde HSM maken

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Sku 'CustomB32' -SoftDeleteRetentionInDays 70
Name  Resource Group Name Location    SKU

----  ------------------- --------    ---
myhsm myrg1               eastus2euap CustomB32

Met deze opdracht maakt u een beheerde HSM, net als in het vorige voorbeeld. Er wordt echter een waarde van CustomB32 opgegeven voor de SKU-parameter om een door CustomB32 beheerde HSM te maken.

Voorbeeld 3: Een beheerde HSM maken met een door de gebruiker toegewezen identiteit

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"-SoftDeleteRetentionInDays 70 -UserAssignedIdentity /subscriptions/xxxx/resourceGroups/xxxx/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName | Format-List
Managed HSM Name                        : myhsm
Resource Group Name                     : myrg1
Location                                : eastus2euap
Resource ID                             : /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/bez-rg/pro
                                          viders/Microsoft.KeyVault/managedHSMs/bezmhsm
HSM Pool URI                            :
Tenant ID                               : 00001111-aaaa-2222-bbbb-3333cccc4444
Initial Admin Object Ids                : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
SKU                                     : StandardB1
Soft Delete Enabled?                    : True
Enabled Purge Protection?               : False
Soft Delete Retention Period (days)     : 70
Public Network Access                   : Enabled
IdentityType                            : UserAssigned
UserAssignedIdentities                  : /subscriptions/xxxx/resourceGroups/xxxx/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName
Provisioning State                      : Succeeded
Status Message                          : The Managed HSM is provisioned and ready to use.
Security Domain ActivationStatus        : Active
Security Domain ActivationStatusMessage : Your HSM has been activated and can be used for cryptographic operations.
Regions                                 :
Tags

Met deze opdracht maakt u een beheerde HSM met een door de gebruiker toegewezen identiteit.

Voorbeeld 4: Een beheerde HSM maken met een initiële netwerkregelset (firewall ingeschakeld)

$ruleSet = New-AzKeyVaultManagedHsmNetworkRuleSetObject -DefaultAction Deny -Bypass AzureServices -IpAddressRange 203.0.113.0/24,198.51.100.10/32
New-AzKeyVaultManagedHsm -Name 'securehsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -SoftDeleteRetentionInDays 30 -NetworkRuleSet $ruleSet
DefaultAction        Bypass IpAddressRanges                    VirtualNetworkResourceIds
-------------        ------ ---------------                    -------------------------
         Deny AzureServices {203.0.113.0/24, 198.51.100.10/32}



Name           Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----           ------------------- -------- ---        ----------------- --------------------------------
mhsm1814428918 kv-mhsm-rg          eastus   StandardB1 Succeeded         NotActivated

$h.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Deny
IPRules             : {203.0.113.0/24, 198.51.100.10/32}
ServiceTags         : {}
VirtualNetworkRules : {}

Met dit patroon kan de firewall worden gemaakt tijdens het maken (DefaultAction Deny) terwijl twee specifieke IP-bereiken plus vertrouwde Azure-services zijn toegestaan. Extra IP-adressen kunnen later worden toegevoegd aan Add-AzKeyVaultManagedHsmNetworkRule.

Parameters

-Administrator

Eerste beheerdersobject-id voor deze beheerde HSM-pool.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:3
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-AsJob

Cmdlet op de achtergrond uitvoeren

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EnablePurgeProtection

opgeven of beveiliging tegen opschonen is ingeschakeld voor deze beheerde HSM-pool. De instelling is alleen van kracht als voorlopig verwijderen ook is ingeschakeld. Het inschakelen van deze functionaliteit kan niet ongedaan worden.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Location

Hiermee geeft u de Azure-regio op waarin de sleutelkluis moet worden gemaakt. Gebruik de opdracht Get-AzResourceProvider met de parameter ProviderNamespace om uw keuzes te bekijken.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u een naam op van de beheerde HSM die moet worden gemaakt. De naam kan elke combinatie van letters, cijfers of afbreekstreepjes zijn. De naam moet beginnen en eindigen met een letter of cijfer. De naam moet universeel uniek zijn.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:HsmName

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NetworkRuleSet

Hiermee geeft u een beheerd HSM-netwerkregelsetobject (van New-AzKeyVaultManagedHsmNetworkRuleSetObject) om standaardactie, bypass, IP-regels en regels voor virtuele netwerken tijdens het maken te configureren.

Parametereigenschappen

Type:PSManagedHsmNetworkRuleSet
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PublicNetworkAccess

Hiermee bepaalt u de machtiging voor gegevensvlakverkeer dat afkomstig is van openbare netwerken terwijl het privé-eindpunt is ingeschakeld.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

Hiermee geeft u de naam op van een bestaande resourcegroep waarin de sleutelkluis moet worden gemaakt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Sku

Hiermee geeft u de SKU van het beheerde HSM-exemplaar.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SoftDeleteRetentionInDays

Hiermee geeft u op hoe lang de verwijderde beheerde hsm-pool wordt bewaard en hoe lang totdat de beheerde hsm-pool met de status Verwijderd kan worden verwijderd.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SubscriptionId

De id van het abonnement. Cmdlets worden standaard uitgevoerd in het abonnement dat is ingesteld in de huidige context. Als de gebruiker een ander abonnement opgeeft, wordt de huidige cmdlet uitgevoerd in het abonnement dat door de gebruiker is opgegeven. Het overschrijven van abonnementen wordt alleen van kracht tijdens de levenscyclus van de huidige cmdlet. Het abonnement wordt niet gewijzigd in de context en heeft geen invloed op volgende cmdlets.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Tag

Een hashtabel die resourcetags vertegenwoordigt.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Tags

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-UserAssignedIdentity

De set door de gebruiker toegewezen identiteiten die zijn gekoppeld aan de beheerde HSM. De waarde ervan is ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

String

Hashtable

Uitvoerwaarden

PSManagedHsm