Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Export-AzKeyVaultSecurityDomain

Exports the security domain data of a managed HSM.

Syntax

ByName (Default)

Export-AzKeyVaultSecurityDomain
 -Name <String>
 -Certificates <String[]>
 -OutputPath <String>
 -Quorum <Int32>
 [-Force]
 [-PassThru]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [-SubscriptionId <String>]
 [<CommonParameters>]

ByInputObject

Export-AzKeyVaultSecurityDomain
 -InputObject <PSKeyVaultIdentityItem>
 -Certificates <String[]>
 -OutputPath <String>
 -Quorum <Int32>
 [-Force]
 [-PassThru]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [-SubscriptionId <String>]
 [<CommonParameters>]

Description

Exports the security domain data of a managed HSM for importing on another HSM.

Examples

Example 1

Export-AzKeyVaultSecurityDomain -Name testmhsm -Certificates sd1.cer, sd2.cer, sd3.cer -OutputPath sd.ps.json -Quorum 2

This command retrieves the managed HSM named testmhsm and saves a backup of that managed HSM security domain to the specified output file.

Parameters

-Certificates

Paths to the certificates that are used to encrypt the security domain data.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Parameter properties

Type:IAzureContextContainer
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

-Force

Specify whether to overwrite existing file.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-InputObject

Object representing a managed HSM.

Parameter properties

Type:PSKeyVaultIdentityItem
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Name

Name of the managed HSM.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:HsmName

Parameter sets

-OutputPath

Specify the path where security domain data will be downloaded to.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-PassThru

When specified, a boolean will be returned when cmdlet succeeds.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Quorum

The minimum number of shares required to decrypt the security domain for recovery.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-SubscriptionId

The ID of the subscription. By default, cmdlets are executed in the subscription that is set in the current context. If the user specifies another subscription, the current cmdlet is executed in the subscription specified by the user. Overriding subscriptions only take effect during the lifecycle of the current cmdlet. It does not change the subscription in the context, and does not affect subsequent cmdlets.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

PSKeyVaultIdentityItem

Outputs

Boolean


Feedback

Was this page helpful?