Información general

Estos son los cmdlets de PowerShell para el módulo MSONLINE, que se usan para la copia de seguridad, y se instalan como parte del instalador del agente de MARS.

Registro mediante el módulo Az de PS

Nota:

En la versión Az 3.5.0, se corrige un error con la generación del certificado de almacén. Use la versión Az 3.5.0 o posterior para descargar un certificado de almacén.

En el módulo Az más reciente de PowerShell, debido a las limitaciones de la plataforma subyacente, la descarga de las credenciales del almacén requiere un certificado autofirmado. En el ejemplo siguiente se muestra cómo proporcionar un certificado autofirmado y descargar las credenciales del almacén.

$dt = $(Get-Date).ToString("M-d-yyyy")
$cert = New-SelfSignedCertificate -CertStoreLocation Cert:\CurrentUser\My -FriendlyName 'test-vaultcredentials' -subject "Windows Azure Tools" -KeyExportPolicy Exportable -NotAfter $(Get-Date).AddHours(48) -NotBefore $(Get-Date).AddHours(-24) -KeyProtection None -KeyUsage None -TextExtension @("2.5.29.37={text}1.3.6.1.5.5.7.3.2") -Provider "Microsoft Enhanced Cryptographic Provider v1.0"
$certficate = [convert]::ToBase64String($cert.Export([System.Security.Cryptography.X509Certificates.X509ContentType]::Pfx))
$CredsFilename = Get-AzRecoveryServicesVaultSettingsFile -Backup -Vault $Vault -Path $CredsPath -Certificate $certficate

En el sistema con Windows Server o el equipo cliente de Windows, ejecute el cmdlet Start-OBRegistration para registrar la máquina en el almacén. Este y otros cmdlets usados para copias de seguridad son del módulo MSONLINE que el instalador del agente de MARS agregó como parte del proceso de instalación.

El instalador del agente no actualiza la variable $Env:PSModulePath. Esto significa que se produce un error en la carga automática del módulo. Para resolver este problema, puede hacer lo siguiente:

$Env:PSModulePath += ';C:\Program Files\Microsoft Azure Recovery Services Agent\bin\Modules'

Como alternativa, puede cargar manualmente el módulo en el script como se indica a continuación:

Import-Module -Name 'C:\Program Files\Microsoft Azure Recovery Services Agent\bin\Modules\MSOnlineBackup'

Después de cargar los cmdlets de Online Backup, registre las credenciales del almacén:

Start-OBRegistration -VaultCredentials $CredsFilename.FilePath -Confirm:$false

CertThumbprint      : 7a2ef2caa2e74b6ed1222a5e89288ddad438df2
SubscriptionID      : ef4ab577-c2c0-43e4-af80-af49f485f3d1
ServiceResourceName : testvault
Region              : WestUS
Machine registration succeeded.

Importante

No use rutas de acceso relativas para especificar el archivo de credenciales del almacén de claves. Debe proporcionar una ruta de acceso absoluta como entrada para el cmdlet.