New-AzKeyVaultManagedHsm

Referência

Módulo:: Az.KeyVault

Cria um HSM gerenciado.

Sintaxe

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

O cmdlet New-AzKeyVaultManagedHsm cria um HSM gerenciado no grupo de recursos especificado. Para adicionar, remover ou listar chaves no HSM gerenciado, o usuário deve:

conceder permissões adicionando a ID do usuário ao Administrador;
adicionar atribuição de função para o usuário como "Usuário de Criptografia de HSM Gerenciado" e assim por diante;
fazer backup de dados de domínio de segurança de um HSM gerenciado usando Export-AzKeyVaultSecurityDomain.

Exemplos

Exemplo 1: Criar um HSM gerenciado do 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

Esse comando cria um HSM gerenciado chamado myhsm no local eastus2euap. O comando adiciona o HSM gerenciado ao grupo de recursos chamado myrg1. Como o comando não especifica um valor para o parâmetro de SKU , ele cria um HSM gerenciado Standard_B1.

Exemplo 2: Criar um HSM gerenciado do CustomB32

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

Esse comando cria um HSM gerenciado, assim como o exemplo anterior. No entanto, ele especifica um valor de CustomB32 para o parâmetro SKU para criar um HSM gerenciado CustomB32.

Exemplo 3: criar um HSM gerenciado com uma identidade atribuída pelo usuário

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

Esse comando cria um HSM gerenciado com uma identidade atribuída pelo usuário.

Parâmetros

-Administrator

ID de objeto de administrador inicial para esse pool de HSM gerenciado.

Tipo:	String[]
Cargo:	3
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnablePurgeProtection

especificando se a proteção contra limpeza está habilitada para esse pool de HSM gerenciado. A configuração só será efetiva se a exclusão reversível também estiver habilitada. Habilitar essa funcionalidade é irreversível.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Location

Especifica a região do Azure na qual criar o cofre de chaves. Use o comando Get-AzResourceProvider com o parâmetro ProviderNamespace para ver suas escolhas.

Tipo:	String
Cargo:	2
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifica um nome do HSM gerenciado a ser criado. O nome pode ser qualquer combinação de letras, dígitos ou hifens. O nome deve iniciar e terminar com uma letra ou dígito. O nome deve ser universalmente exclusivo.

Tipo:	String
Aliases:	HsmName
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-PublicNetworkAccess

Controla a permissão para o tráfego de plano de dados proveniente de redes públicas enquanto o ponto de extremidade privado está habilitado.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

Especifica o nome de um grupo de recursos existente no qual criar o cofre de chaves.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Sku

Especifica o SKU da instância de HSM gerenciada.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SoftDeleteRetentionInDays

Especifica por quanto tempo o pool de hsm gerenciado excluído é mantido e quanto tempo até que o pool de hsm gerenciado no estado excluído possa ser limpo.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SubscriptionId

A ID da assinatura. Por padrão, os cmdlets são executados na assinatura definida no contexto atual. Se o usuário especificar outra assinatura, o cmdlet atual será executado na assinatura especificada pelo usuário. A substituição de assinaturas só tem efeito durante o ciclo de vida do cmdlet atual. Ele não altera a assinatura no contexto e não afeta os cmdlets subsequentes.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Tag

Uma tabela de hash que representa marcas de recurso.

Tipo:	Hashtable
Aliases:	Tags
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-UserAssignedIdentity

O conjunto de identidades atribuídas pelo usuário associadas ao HSM gerenciado. Seu valor será ids de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

String

String[]

Hashtable

Saídas

PSManagedHsm

Compartilhar via

New-AzKeyVaultManagedHsm

Sintaxe

Description

Exemplos

Exemplo 1: Criar um HSM gerenciado do StandardB1

Exemplo 2: Criar um HSM gerenciado do CustomB32

Exemplo 3: criar um HSM gerenciado com uma identidade atribuída pelo usuário

Parâmetros

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

Entradas

Saídas

Recursos adicionais

Compartilhar via

New-AzKeyVaultManagedHsm

Sintaxe

Description

Exemplos

Exemplo 1: Criar um HSM gerenciado do StandardB1

Exemplo 2: Criar um HSM gerenciado do CustomB32

Exemplo 3: criar um HSM gerenciado com uma identidade atribuída pelo usuário

Parâmetros

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

Entradas

Saídas

Links Relacionados

Recursos adicionais