Get-AzureRmRecoveryServicesVaultSettingsFile

Gets the Azure Site Recovery vault settings file.

Syntax

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

Description

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

Examples

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

PS C:\> $Vault01 = Get-AzureRmRecoveryServicesVault -Name "TestVault"
PS C:\> $CredsPath = "C:\Downloads"
PS C:\> $Credsfilename = Get-AzureRmRecoveryServicesVaultSettingsFile -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:

PS C:\> $Credsfilename = Get-AzureRmRecoveryServicesVaultSettingsFile -SiteIdentifier -Vault $Vault01

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

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

PS C:\> $Credsfilename = Get-AzureRmRecoveryServicesVaultSettingsFile -SiteIdentifier -Vault $Vault01

The command gets the vault credentials file for $Vault01.

Required Parameters

-Backup

Indicates the vault credentials file is applicable to Azure Backup.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteFriendlyName

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

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

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

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

Specifies the Azure Site Recovery vault object.

Type:Microsoft.Azure.Commands.RecoveryServices.ARSVault
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional Parameters

-DefaultProfile

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

Type:Microsoft.Azure.Commands.Common.Authentication.Abstractions.IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteRecovery

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

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

ARSVault

Parameter 'Vault' accepts value of type 'ARSVault' from the pipeline

Outputs

Microsoft.Azure.Commands.RecoveryServices.VaultSettingsFilePath