Initialize-AzDataProtectionRestoreRequest

Riferimento

Modulo:: Az.DataProtection

Inizializza l'oggetto Richiesta di ripristino per attivare il ripristino in un'istanza di backup protetta.

Sintassi

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          -TargetResourceId <String>
          [-RecoveryPoint <String>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          [-PointInTime <DateTime>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          -TargetResourceId <String>
          [-ItemLevelRecovery]
          [-RecoveryPoint <String>]
          [-ContainersList <String[]>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          [-ItemLevelRecovery]
          [-RecoveryPoint <String>]
          [-ContainersList <String[]>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          -BackupInstance <BackupInstanceResource>
          [-PointInTime <DateTime>]
          [-FromPrefixPattern <String[]>]
          [-ToPrefixPattern <String[]>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          [-RecoveryPoint <String>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          -BackupInstance <BackupInstanceResource>
          [-PointInTime <DateTime>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          [-RecoveryPoint <String>]
          -TargetContainerURI <String>
          -FileNamePrefix <String>
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-TargetResourceIdForRestoreAsFile <String>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          [<CommonParameters>]

Descrizione

Inizializza l'oggetto Richiesta di ripristino per attivare il ripristino in un'istanza di backup protetta.

Esempio

Esempio 1: Ottenere l'oggetto richiesta di ripristino per l'istanza di Backup dischi di Azure protetta

$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "sarath-rg" -VaultName "sarath-vault"
$rp = Get-AzDataProtectionRecoveryPoint -SubscriptionId "xxx-xxx-xxx" -ResourceGroupName "sarath-rg" -VaultName "sarath-vault" -BackupInstanceName $instance.Name
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureDisk -SourceDataStore OperationalStore -RestoreLocation "westus"  -RestoreType AlternateLocation -TargetResourceId "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/disks/{DiskName}" -RecoveryPoint "892e5c5014dc4a96807d22924f5745c9"

ObjectType                                  RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointI
                                                                                                                                                             d
----------                                  --------------------------- ------------------------------- -------------------------------- ------------------- --------------
AzureBackupRecoveryPointBasedRestoreRequest RestoreTargetInfo           FailIfExists                    westus                           OperationalStore    892e5c5014dc4a96807d22924f5745c9

Questo comando inizializza un oggetto richiesta di ripristino che può essere usato per attivare il ripristino.

Esempio 2: Ottenere l'oggetto richiesta di ripristino per l'istanza di Backup BLOB di Azure protetta

$startTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$endTime = (Get-Date).AddDays(0).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "rgName" -VaultName "vaultName"
$pointInTimeRange = Find-AzDataProtectionRestorableTimeRange -BackupInstanceName $instance[0].BackupInstanceName -ResourceGroupName "rgName" -SubscriptionId "subscriptionId"  -VaultName "vaultName" -SourceDataStoreType OperationalStore -StartTime $startTime -EndTime $endTime
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureBlob -SourceDataStore OperationalStore -RestoreLocation $vault.Location -RestoreType OriginalLocation -BackupInstance $instance[0] -PointInTime (Get-Date -Date $pointInTimeRange.RestorableTimeRange.EndTime)

ObjectType                                 RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointTime
----------                                 --------------------------- ------------------------------- -------------------------------- ------------------- -----------------
AzureBackupRecoveryTimeBasedRestoreRequest restoreTargetInfo           FailIfExists                    eastus2euap                      OperationalStore    2021-04-24T13:32:41.7018481Z

Questo comando inizializza un oggetto richiesta di ripristino che può essere usato per attivare il ripristino per i BLOB.

Esempio 3: Ottenere l'oggetto richiesta di ripristino per il ripristino a livello di elemento per i contenitori nell'istanza protetta di Backup Di AzureBlob

$startTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$endTime = (Get-Date).AddDays(0).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "rgName" -VaultName "vaultName"
$pointInTimeRange = Find-AzDataProtectionRestorableTimeRange -BackupInstanceName $instance[0].BackupInstanceName -ResourceGroupName "rgName" -SubscriptionId "subscriptionId"  -VaultName "vaultName" -SourceDataStoreType OperationalStore -StartTime $startTime -EndTime $endTime
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureBlob -SourceDataStore OperationalStore -RestoreLocation $vault.Location -RestoreType OriginalLocation -BackupInstance $instances[0] -PointInTime (Get-Date).AddDays(-1) -ItemLevelRecovery -ContainersList "containerName1","containerName2"

ObjectType                                 RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointTime
----------                                 --------------------------- ------------------------------- -------------------------------- ------------------- -----------------
AzureBackupRecoveryTimeBasedRestoreRequest itemLevelRestoreTargetInfo  FailIfExists                    eastus2euap                      OperationalStore    2021-04-23T02:47:02.9500000Z

Questo comando inizializza un oggetto richiesta di ripristino che può essere usato per attivare il ripristino a livello di elemento a livello di contenitore per i BLOB.

Esempio 4: Ottenere l'oggetto richiesta di ripristino per il ripristino a livello di elemento per contenitori/prefixMatch nell'istanza protetta di Backup Di AzureBlob

$startTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$endTime = (Get-Date).AddDays(0).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "rgName" -VaultName "vaultName"
$pointInTimeRange = Find-AzDataProtectionRestorableTimeRange -BackupInstanceName $instance[0].BackupInstanceName -ResourceGroupName "rgName" -SubscriptionId "subscriptionId"  -VaultName "vaultName" -SourceDataStoreType OperationalStore -StartTime $startTime -EndTime $endTime
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureBlob -SourceDataStore OperationalStore -RestoreLocation $vault.Location -RestoreType OriginalLocation -BackupInstance $instances[0] -PointInTime (Get-Date).AddDays(-1) -ItemLevelRecovery -FromPrefixPattern "container1/aaa","container1/ccc", "container2/aab", "container3" -ToPrefixPattern "container1/bbb","container1/ddd", "container2/abc", "container3-0"

ObjectType                                 RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointTime
----------                                 --------------------------- ------------------------------- -------------------------------- ------------------- -----------------
AzureBackupRecoveryTimeBasedRestoreRequest itemLevelRestoreTargetInfo  FailIfExists                    eastus2euap                      OperationalStore    2021-04-23T02:47:02.9500000Z

Questo comando inizializza un oggetto richiesta di ripristino che può essere usato per attivare il recupero a livello di elemento a livello di BLOB in base ai prefissi dei nomi nei contenitori BLOB.

Il ripristino precedenteRequest ripristina i contenitori/BLOB seguenti:

FromPrefix ToPrefix "container1/aaa" "container1/bbb" (ripristina tutti i BLOB corrispondenti in questo intervallo di prefissi) "container1/ccc" "container1/ddd" "container2/aab" "container2/abc" "container3" "container3-0" (ripristina l'intero contenitore3)

Nota: gli intervalli non devono sovrapporsi tra loro. Riferimento: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

Parametri

-BackupInstance

Oggetto Istanza di backup per attivare il ripristino locale originale. Per costruire, vedere la sezione NOTES per le proprietà BACKUPINSTANCE e creare una tabella hash.

Type:	Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20231101.BackupInstanceResource
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ContainersList

Nomi dei contenitori per il ripristino a livello di elemento.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatasourceType

Tipo di origine dati

Type:	DatasourceTypes
Accepted values:	AzureDisk, AzureBlob, AzureDatabaseForPostgreSQL, AzureKubernetesService
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FileNamePrefix

Nome file con prefisso ai dati di backup ripristinati.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FromPrefixPattern

Valore minimo corrispondente per il recupero a livello di elemento.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ItemLevelRecovery

Impostare il parametro per abilitare il ripristino a livello di elemento.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PointInTime

Temporizzato per il ripristino.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecoveryPoint

ID del punto di ripristino da ripristinare.

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

-RehydrationDuration

La durata della riattivazione per il punto di ripristino archiviato rimane riattivata, il valore predefinito per la durata della riattivazione è 15.

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

-RehydrationPriority

Priorità di riattivazione per il punto di ripristino archiviato. Questo parametro è obbligatorio per il ripristino riattivato dei punti archiviati.

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

-RestoreConfiguration

Configurazione di ripristino per il ripristino. Usare questo parametro per eseguire il ripristino con AzureKubernetesService. Per costruire, vedere la sezione NOTES per le proprietà RESTORECONFIGURATION e creare una tabella hash.

Type:	Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20231101.KubernetesClusterRestoreCriteria
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreLocation

Percorso di ripristino di destinazione

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreType

Ripristina tipo di destinazione

Type:	RestoreTargetType
Accepted values:	AlternateLocation, OriginalLocation, RestoreAsFiles
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SecretStoreType

Tipo di archivio segreto per l'autenticazione dell'archivio segreto dell'origine dati. Questo parametro è attualmente supportato solo per AzureDatabaseForPostgreSQL.

Type:	SecretStoreTypes
Accepted values:	AzureKeyVault
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecretStoreURI

URI segreto per l'autenticazione dell'archivio segreto dell'origine dati. Questo parametro è attualmente supportato solo per AzureDatabaseForPostgreSQL.

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

-SourceDataStore

Tipo di archivio dati del punto di ripristino

Type:	DataStoreType
Accepted values:	ArchiveStore, OperationalStore, VaultStore
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetContainerURI

ID contenitore dell'account di archiviazione di destinazione in cui verranno ripristinati i dati di backup come file.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetResourceId

Specificare l'ID risorsa di destinazione per il ripristino dei dati di backup in un percorso alternativo. Ad esempio, specificare l'ID ARM del database di destinazione in cui si vuole eseguire il ripristino per workloadType AzureDatabaseForPostgreSQL.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetResourceIdForRestoreAsFile

ID arm del contenitore dell'account di archiviazione di destinazione in cui verranno ripristinati i dati di backup come file. Questo parametro è obbligatorio per il ripristino come file in un'altra sottoscrizione.

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

-ToPrefixPattern

Valore massimo di corrispondenza per il recupero a livello di elemento.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Output

IAzureBackupRestoreRequest

Note

ALIAS

PROPRIETÀ DEI PARAMETRI COMPLESSI

Per creare i parametri descritti di seguito, creare una tabella hash contenente le proprietà appropriate. Per informazioni sulle tabelle hash, eseguire get-help about_Hash_Tables.

BACKUPINSTANCE <BackupInstanceResource>: oggetto Istanza di backup per attivare il ripristino locale originale.

[Property <IBackupInstance>]: proprietà BackupInstanceResource
- DataSourceInfo <IDatasource>: ottiene o imposta le informazioni sull'origine dati.
  - ResourceId <String>: ID ARM completo della risorsa. Per le risorse di Azure, si tratta dell'ID ARM. Per le risorse non di Azure, questo sarà l'ID creato dal servizio di backup tramite Fabric/Vault.
  - [ObjectType <String>]: tipo di oggetto Origine dati, utilizzato per inizializzare il tipo ereditato corretto
  - [ResourceLocation <String>]: posizione dell'origine dati.
  - [ResourceName <String>]: identificatore univoco della risorsa nel contesto dell'elemento padre.
  - [ResourceType <String>]: tipo di risorsa dell'origine dati.
  - [ResourceUri <String>]: URI della risorsa.
  - [Type <String>]: DatasourceType della risorsa.
- ObjectType <String>:
- PolicyInfo <IPolicyInfo>: ottiene o imposta le informazioni sui criteri.
  - PolicyId <String>:
  - [PolicyParameter <IPolicyParameters>]: parametri dei criteri per l'istanza di backup
    - [BackupDatasourceParametersList <IBackupDatasourceParameters[]>]: ottiene o imposta i parametri dell'origine dati di backup
      - ObjectType <String>: tipo dell'oggetto specifico utilizzato per la deserializzazione
    - [DataStoreParametersList <IDataStoreParameters[]>]: ottiene o imposta i parametri dell'archivio dati
      - DataStoreType <DataStoreTypes>: tipo di archivio dati; Operational/Vault/Archive
      - ObjectType <String>: tipo dell'oggetto specifico utilizzato per la deserializzazione
- [DataSourceSetInfo <IDatasourceSet>]: ottiene o imposta le informazioni sul set di origini dati.
  - ResourceId <String>: ID ARM completo della risorsa. Per le risorse di Azure, si tratta dell'ID ARM. Per le risorse non di Azure, questo sarà l'ID creato dal servizio di backup tramite Fabric/Vault.
  - [DatasourceType <String>]: DatasourceType della risorsa.
  - [ObjectType <String>]: tipo di oggetto Origine dati, utilizzato per inizializzare il tipo ereditato corretto
  - [ResourceLocation <String>]: posizione dell'origine dati.
  - [ResourceName <String>]: identificatore univoco della risorsa nel contesto dell'elemento padre.
  - [ResourceType <String>]: tipo di risorsa dell'origine dati.
  - [ResourceUri <String>]: URI della risorsa.
- [DatasourceAuthCredentials <IAuthCredentials>]: credenziali da usare per l'autenticazione con il provider dell'origine dati.
  - ObjectType <String>: tipo dell'oggetto specifico utilizzato per la deserializzazione
- [FriendlyName <String>]: ottiene o imposta il nome descrittivo dell'istanza di backup.
- [IdentityDetail <IIdentityDetails>]: contiene informazioni sui dettagli dell'identità per l'bi. Se è null, il valore predefinito verrà considerato assegnato dal sistema.
  - [UseSystemAssignedIdentity <Boolean?>]: specifica se l'entità business intelligence è protetta dall'identità del sistema.
  - [UserAssignedIdentityArmUrl <String>]: URL arm per identità assegnata dall'utente.
- [ValidationType <ValidationType?>]: specifica il tipo di convalida. In caso di DeepValidation, tutte le convalide dell'API /validateForBackup verranno eseguite di nuovo.
[Tag <IDppProxyResourceTags>]: tag di risorsa proxy.
- [(Any) <String>]: indica che qualsiasi proprietà può essere aggiunta a questo oggetto.

RESTORECONFIGURATION <KubernetesClusterRestoreCriteria>: ripristino della configurazione per il ripristino. Usare questo parametro per eseguire il ripristino con AzureKubernetesService.

IncludeClusterScopeResource <Boolean>: ottiene o imposta la proprietà include risorse cluster. Questa proprietà se abilitata includerà le risorse dell'ambito del cluster durante il ripristino.
ObjectType <String>: tipo dell'oggetto specifico utilizzato per la deserializzazione
[ConflictPolicy <ExistingResourcePolicy?>]: ottiene o imposta la proprietà Criteri di conflitto. Questa proprietà imposta i criteri durante il conflitto di risorse durante il ripristino.
[ExcludedNamespace <String[]>]: ottiene o imposta la proprietà exclude namespaces. Questa proprietà imposta gli spazi dei nomi da escludere durante il ripristino.
[ExcludedResourceType <String[]>]: ottiene o imposta la proprietà exclude resource types. Questa proprietà imposta i tipi di risorsa da escludere durante il ripristino.
[IncludedNamespace <String[]>]: ottiene o imposta la proprietà include namespaces. Questa proprietà imposta gli spazi dei nomi da includere durante il ripristino.
[IncludedResourceType <String[]>]: ottiene o imposta la proprietà include resource types. Questa proprietà imposta i tipi di risorsa da includere durante il ripristino.
[LabelSelector <String[]>]: ottiene o imposta la proprietà LabelSelectors. Questa proprietà imposta la risorsa con tali selettori di etichetta da includere durante il ripristino.
[NamespaceMapping <IKubernetesClusterRestoreCriteriaNamespaceMappings>]: ottiene o imposta la proprietà Mapping dello spazio dei nomi. Questa proprietà imposta se lo spazio dei nomi deve essere modificato durante il ripristino.
- [(Any) <String>]: indica che qualsiasi proprietà può essere aggiunta a questo oggetto.
[PersistentVolumeRestoreMode <PersistentVolumeRestoreMode?>]: ottiene o imposta la proprietà Modalità di ripristino pv (volume persistente). Questa proprietà imposta se i volumi devono essere ripristinati.
[RestoreHookReference <INamespacedNameResource[]>]: ottiene o imposta i riferimenti all'hook di ripristino. Questa proprietà imposta il riferimento hook da eseguire durante il ripristino.
- [Name <String>]: nome della risorsa
- [Namespace <String>]: spazio dei nomi in cui esiste la risorsa