Edit

Share via


Get-AzRecoveryServicesVaultSettingsFile

Gets the Azure Site Recovery vault settings file.

Syntax

ForSiteWithCertificate

Get-AzRecoveryServicesVaultSettingsFile
    [-Vault] <ARSVault>
    [[-Path] <String>]
    -SiteIdentifier <String>
    -SiteFriendlyName <String>
    [-Certificate <String>]
    [-SiteRecovery]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByDefaultWithCertificate

Get-AzRecoveryServicesVaultSettingsFile
    [-Vault] <ARSVault>
    [[-Path] <String>]
    [-Certificate <String>]
    [-SiteRecovery]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ForBackupVaultTypeWithCertificate

Get-AzRecoveryServicesVaultSettingsFile
    [-Vault] <ARSVault>
    [[-Path] <String>]
    [-Certificate <String>]
    [-Backup]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

The Get-AzRecoveryServicesVaultSettingsFile cmdlet gets the settings file for an Azure Site Recovery vault.

Examples

Example 1: Register a Windows Server or DPM machine for Azure Backup

$Vault01 = Get-AzRecoveryServicesVault -Name "TestVault"
$CredsPath = "C:\Downloads"
$Credsfilename = Get-AzRecoveryServicesVaultSettingsFile -Backup -Vault $Vault01 -Path $CredsPath

The first command gets the vault named TestVault, and then stores it in the $Vault01 variable. The second command sets the $CredsPath variable to C:\Downloads. The last command gets the vault credentials file for $Vault01 using the credentials in $CredsPath for Azure Backup.

Example 2

$Credsfilename = Get-AzRecoveryServicesVaultSettingsFile -SiteRecovery -Vault $Vault01

The command gets the vault credentials file for $Vault01 of vault type siteRecovery.

Parameters

-Backup

Indicates the vault credentials file is applicable to Azure Backup.

Parameter properties

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

Parameter sets

ForBackupVaultTypeWithCertificate
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Certificate

{{Fill Certificate Description}}

Parameter properties

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

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-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

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Path

Specifies the path to the Azure Site Recovery vault settings file. You can download this file from the Azure Site Recovery vault portal and store it locally.

Parameter properties

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

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteFriendlyName

Specifies the site friendly name. Use this parameter if you are downloading the vault credentials for a Hyper-V site.

Parameter properties

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

Parameter sets

ForSiteWithCertificate
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteIdentifier

Specifies the site identifier. Use this parameter if you are downloading the vault credentials for a Hyper-V site.

Parameter properties

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

Parameter sets

ForSiteWithCertificate
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteRecovery

Indicates the vault credentials file is applicable to Azure Site Recovery.

Parameter properties

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

Parameter sets

ForSiteWithCertificate
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ByDefaultWithCertificate
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Vault

Specifies the Azure Site Recovery vault object.

Parameter properties

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

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

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

ARSVault

Outputs

VaultSettingsFilePath