New-AzKeyVaultManagedHsm

Riferimento

Modulo:: Az.KeyVault

Crea un modulo di protezione hardware gestito.

Sintassi

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>]

Descrizione

Il cmdlet New-AzKeyVaultManagedHsm crea un modulo di protezione hardware gestito nel gruppo di risorse specificato. Per aggiungere, rimuovere o elencare chiavi nel modulo di protezione hardware gestito, l'utente deve:

concedere le autorizzazioni aggiungendo l'ID utente a Amministrazione istrator;
aggiungere un'assegnazione di ruolo per l'utente, ad esempio "HSM gestito Crypto User" e così via;
eseguire il backup dei dati del dominio di sicurezza di un modulo di protezione hardware gestito usando Export-AzKeyVaultSecurityDomain.

Esempio

Esempio 1: Creare un modulo di protezione hardware gestito StandardB1

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

Questo comando crea un modulo di protezione hardware gestito denominato myhsm nella località eastus2euap. Il comando aggiunge il modulo di protezione hardware gestito al gruppo di risorse denominato myrg1. Poiché il comando non specifica un valore per il parametro SKU , crea un modulo di protezione hardware gestito Standard_B1.

Esempio 2: Creare un modulo di protezione hardware gestito personalizzatoB32

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

Questo comando crea un modulo di protezione hardware gestito, come nell'esempio precedente. Specifica tuttavia un valore CustomB32 per il parametro SKU per creare un modulo di protezione hardware gestito CustomB32.

Esempio 3: Creare un modulo di protezione hardware gestito con un'identità assegnata dall'utente

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

Questo comando crea un modulo di protezione hardware gestito con un'identità assegnata dall'utente.

Parametri

-Administrator

ID oggetto amministratore iniziale per questo pool di moduli di protezione hardware gestito.

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

-AsJob

Eseguire il cmdlet in background

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-EnablePurgeProtection

specificando se la protezione dall'eliminazione è abilitata per questo pool di moduli di protezione hardware gestito. L'impostazione è valida solo se è abilitata anche l'eliminazione temporanea. L'abilitazione di questa funzionalità è irreversibile.

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

-Location

Specifica l'area di Azure in cui creare l'insieme di credenziali delle chiavi. Usare il comando Get-AzResourceProvider con il parametro ProviderNamespace per visualizzare le scelte desiderate.

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

-Name

Specifica un nome del modulo di protezione hardware gestito da creare. Il nome può essere qualsiasi combinazione di lettere, cifre o trattini. Il nome deve iniziare e terminare con una lettera o una cifra. Il nome deve essere universalmente univoco.

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

-PublicNetworkAccess

Controlla l'autorizzazione per il traffico del piano dati proveniente da reti pubbliche mentre l'endpoint privato è abilitato.

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

-ResourceGroupName

Specifica il nome di un gruppo di risorse esistente in cui creare l'insieme di credenziali delle chiavi.

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

-Sku

Specifica lo SKU dell'istanza del modulo di protezione hardware gestito.

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

-SoftDeleteRetentionInDays

Specifica per quanto tempo viene mantenuto il pool hsm gestito eliminato e per quanto tempo il pool di moduli di protezione hardware gestito nello stato eliminato può essere eliminato.

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

-SubscriptionId

ID della sottoscrizione. Per impostazione predefinita, i cmdlet vengono eseguiti nella sottoscrizione impostata nel contesto corrente. Se l'utente specifica un'altra sottoscrizione, il cmdlet corrente viene eseguito nella sottoscrizione specificata dall'utente. L'override delle sottoscrizioni ha effetto solo durante il ciclo di vita del cmdlet corrente. Non modifica la sottoscrizione nel contesto e non influisce sui cmdlet successivi.

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

-Tag

Tabella hash che rappresenta i tag delle risorse.

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

-UserAssignedIdentity

Set di identità assegnate dall'utente associate al modulo di protezione hardware gestito. Il valore sarà l'ID risorsa ARM nel formato :'/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

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

String[]

Hashtable

Output

PSManagedHsm

New-AzKeyVaultManagedHsm

Sintassi

Descrizione

Esempio

Esempio 1: Creare un modulo di protezione hardware gestito StandardB1

Esempio 2: Creare un modulo di protezione hardware gestito personalizzatoB32

Esempio 3: Creare un modulo di protezione hardware gestito con un'identità assegnata dall'utente

Parametri

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

Input

Output

Commenti e suggerimenti

Risorse aggiuntive

New-AzKeyVaultManagedHsm

Sintassi

Descrizione

Esempio

Esempio 1: Creare un modulo di protezione hardware gestito StandardB1

Esempio 2: Creare un modulo di protezione hardware gestito personalizzatoB32

Esempio 3: Creare un modulo di protezione hardware gestito con un'identità assegnata dall'utente

Parametri

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

Input

Output

Collegamenti correlati

Commenti e suggerimenti

Risorse aggiuntive