New-AzKeyVaultManagedHsm

Referens

Modul:: Az.KeyVault

Skapar en hanterad HSM.

Syntax

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

Description

Cmdleten New-AzKeyVaultManagedHsm skapar en hanterad HSM i den angivna resursgruppen. Om du vill lägga till, ta bort eller visa nycklar i den hanterade HSM:en ska användaren:

bevilja behörigheter genom att lägga till användar-ID i Administratör;
lägg till rolltilldelning för användare som "Hanterad HSM-kryptoanvändare" och så vidare;
säkerhetskopiera säkerhetsdomändata för en hanterad HSM med .Export-AzKeyVaultSecurityDomain

Exempel

Exempel 1: Skapa en StandardB1-hanterad HSM

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

Det här kommandot skapar en hanterad HSM med namnet myhsm på platsen eastus2euap. Kommandot lägger till den hanterade HSM:en i resursgruppen med namnet myrg1. Eftersom kommandot inte anger något värde för SKU-parametern skapas en Standard_B1 hanterad HSM.

Exempel 2: Skapa en CustomB32-hanterad HSM

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

Det här kommandot skapar en hanterad HSM, precis som i föregående exempel. Det anger dock värdet CustomB32 för SKU-parametern för att skapa en CustomB32-hanterad HSM.

Exempel 3: Skapa en hanterad HSM med en användartilldelad identitet

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                               : 54826b22-38d6-4fb2-bad9-b7b93a3e9c5a
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

Det här kommandot skapar en hanterad HSM med en användartilldelad identitet.

Parametrar

-Administrator

Initialt administratörsobjekt-ID för den här hanterade HSM-poolen.

Type:	String[]
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

Kör cmdlet i bakgrunden

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-EnablePurgeProtection

ange om skydd mot rensning är aktiverat för den här hanterade HSM-poolen. Inställningen är endast effektiv om mjuk borttagning också är aktiverad. Det går inte att ångra aktiveringen av den här funktionen.

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

-Location

Anger i vilken Azure-region nyckelvalvet ska skapas. Använd kommandot Get-AzResourceProvider med parametern ProviderNamespace för att se dina val.

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

-Name

Anger ett namn på den hanterade HSM som ska skapas. Namnet kan vara valfri kombination av bokstäver, siffror eller bindestreck. Namnet måste börja och sluta med en bokstav eller siffra. Namnet måste vara universellt unikt.

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

-PublicNetworkAccess

Styr behörigheten för dataplanstrafik som kommer från offentliga nätverk medan den privata slutpunkten är aktiverad.

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

-ResourceGroupName

Anger namnet på en befintlig resursgrupp där nyckelvalvet ska skapas.

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

-Sku

Anger SKU för den hanterade HSM-instansen.

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

-SoftDeleteRetentionInDays

Anger hur länge den borttagna hanterade HSM-poolen ska behållas och hur lång tid tills den hanterade HSM-poolen i borttaget tillstånd kan rensas.

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

-SubscriptionId

ID:t för prenumerationen. Som standard körs cmdletar i den prenumeration som anges i den aktuella kontexten. Om användaren anger en annan prenumeration körs den aktuella cmdleten i den prenumeration som användaren har angett. Åsidosättande prenumerationer träder endast i kraft under livscykeln för den aktuella cmdleten. Den ändrar inte prenumerationen i kontexten och påverkar inte efterföljande cmdletar.

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

-Tag

En hash-tabell som representerar resurstaggar.

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

-UserAssignedIdentity

Uppsättningen användartilldelade identiteter som är associerade med den hanterade HSM:n. Värdet är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

String[]

Hashtable

Utdata

PSManagedHsm

New-AzKeyVaultManagedHsm

Syntax

Description

Exempel

Exempel 1: Skapa en StandardB1-hanterad HSM

Exempel 2: Skapa en CustomB32-hanterad HSM

Exempel 3: Skapa en hanterad HSM med en användartilldelad identitet

Parametrar

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

Indata

Utdata

Feedback

Ytterligare resurser

New-AzKeyVaultManagedHsm

Syntax

Description

Exempel

Exempel 1: Skapa en StandardB1-hanterad HSM

Exempel 2: Skapa en CustomB32-hanterad HSM

Exempel 3: Skapa en hanterad HSM med en användartilldelad identitet

Parametrar

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

Indata

Utdata

Relaterade länkar

Feedback

Ytterligare resurser