Restore-SqlDatabase

Modulo:

SqlServer Module

Ripristina un database da un record di backup o di log delle transazioni.

Sintassi

ByPath (impostazione predefinita).

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Path <String[]>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

Restore-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Restore-SqlDatabase esegue operazioni di ripristino in un database di SQL Server. Sono inclusi ripristini completi del database, ripristini del log delle transazioni e ripristini di file di database.

Questo cmdlet viene modellato dopo la classe Microsoft.SqlServer.Management.Smo.Restore. I parametri di questo cmdlet corrispondono in genere alle proprietà dell'oggetto Smo.Restore.

Esempio

Esempio 1: Ripristinare un database da un file di backup in una condivisione di rete

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak"

Questo comando ripristina il database MainDB completo dal file \\mainserver\databasebackup\MainDB.bak all'istanza Computer\Instancedel server .

Esempio 2: Ripristinare un log delle transazioni del database

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log

Questo comando ripristina il log delle transazioni per il database MainDB dal file \\mainserver\databasebackup\MainDB.trn all'istanza Computer\Instancedel server .

Esempio 3: Ripristinare un database e richiedere una password

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak" -Credential (Get-Credential "sa")

Questo comando ripristina il database MainDB completo dal file \\mainserver\databasebackup\MainDB.bak all'istanza Computer\Instancedel server usando l'account sa di accesso SQL. Questo comando richiederà la password per completare l'autenticazione.

Esempio 4: Ripristinare un log delle transazioni con l'opzione NORECOVERY

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -NoRecovery

Questo comando ripristina il log delle transazioni del database MainDB con l'opzione NORECOVERY dal file \\mainserver\databasebackup\MainDB.trn all'istanza Computer\Instancedel server .

Esempio 5: Ripristinare i record del log delle transazioni fino a un punto nel tempo

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -ToPointInTime "Sep 21, 2017 11:11 PM"

Questo comando ripristina il log delle transazioni del database MainDB fino alla data passata al parametro ToPointInTime , 21 settembre 2017 11:11 PM.

Esempio 6: Ripristinare un database e rilocare i file di dati e di log

PS C:\> $RelocateData = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Data", "c:\MySQLServer\MainDB.mdf")
PS C:\> $RelocateLog = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Log", "c:\MySQLServer\MainDB.ldf")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RelocateFile @($RelocateData,$RelocateLog)

In questo esempio viene ripristinato il database MainDB completo nell'istanza Computer\Instancedel server e vengono rilocati i file di dati e di log. Per ogni file spostato, nell'esempio viene creata un'istanza della classe Microsoft.SqlServer.Management.Smo.RelocateFile. Ogni costruttore accetta due argomenti, il nome logico del file e il percorso fisico in cui il file verrà inserito nel server di destinazione. Gli oggetti RelocateFile vengono passati al parametro RelocateFile del cmdlet Restore-SqlDatabase .

Esempio 7: Ripristinare un database da nastro

PS C:\> $TapeDevice = New-Object Microsoft.Sqlserver.Management.Smo.BackupDeviceItem("\\.\tape0", "Tape")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupDevice $TapeDevice

In questo esempio il database MainDB viene ripristinato dal dispositivo nastro denominato \\.\tape0 all'istanza Computer\Instancedel server . Per rappresentare questo dispositivo, nell'esempio viene creata un'istanza della classe Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. Il costruttore accetta due argomenti, il nome del dispositivo di backup e il tipo del dispositivo di backup. Questo oggetto BackupDeviceItem viene quindi passato al parametro BackupDevice del cmdlet Restore-SqlDatabase .

Esempio 8: Ripristinare un database dal servizio archiviazione BLOB di Azure

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "https://mystorageaccountname.blob.core.windows.net/container/MyDB.bak" -SqlCredential "mySqlCredential"

Questo comando ripristina il database MainDB completo dal file nel servizio Archiviazione BLOB di Windows Azure all'istanza Computer\Instancedel server .

Esempio 9: Eseguire il backup di un database in SQL2016 e ripristinare in SQL2017 usando -AutoRelocateFile

PS C:\> Get-SqlDatabase -ServerInstance MYSERVER\SQL2016 -Database AdventureWorks | Backup-SqlDatabase -BackupFile 'C:\BAK2\AdventureWorks.bak'
PS C:\> $restore = Restore-SqlDatabase -ServerInstance MYSERVER\SQL2017 -Database AdventureWorks2016 -BackupFile 'C:\BAK2\AdventureWorks.bak' -AutoRelocateFile -PassThru
PS C:\> $db.RelocateFiles

LogicalFileName     PhysicalFileName
---------------     ----------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Log.ldf

# You can see that the original PhysicalFileNames were indeed differet by running the followiong query:
PS C:\> Invoke-Sqlcmd -ServerInstance MYSERVER\SQL2016 -Query "RESTORE FILELISTONLY FROM  DISK = N'C:\BAK2\AdventureWorks.bak' WITH NOUNLOAD" | Select -Property LogicalName,PhysicalName

LogicalName         PhysicalName
-----------         ------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Log.ldf

Il primo comando esegue un backup del database AdventureWorks in SQL2016'istanza in esecuzione nel computer MYSERVER. Il backup viene salvato in C:\BAK2.

Lo stesso file di backup viene usato nel secondo cmdlet per ripristinare il database in un'istanza di SQL2017 in esecuzione nello stesso computer (MYSERVER). Si noti che senza l'opzione -AutoRelocate il cmdlet non è riuscito perché i file fisici in cui sono diversi, come illustrato nelle due tabelle precedenti (inoltre, probabilmente i file sarebbero stati usati da SQL2016 e possibilmente non accessibili da SQL2017). -AutoRelocate ha consentito all'utente di evitare di dover usare esplicitamente -RelocationFile, l'argomento a cui è piuttosto noioso da compilare.

Nota: si presuppone che sia l'istanza SQL2016 che SQL2017'istanza abbiano accesso alla cartella C:\BAK2 .

Parametri

-AccessToken

Token di accesso usato per eseguire l'autenticazione a SQL Server, come alternativa all'autenticazione utente/password o windows.

Può essere usato, ad esempio, per connettersi a SQL Azure DB e SQL Azure Managed Instance usando un Service Principal oggetto o .Managed Identity

Il parametro da usare può essere una stringa che rappresenta il token o un PSAccessToken oggetto restituito eseguendo Get-AzAccessToken -ResourceUrl https://database.windows.net.

Questo parametro è nuovo nella versione 22 del modulo.

Proprietà dei parametri

Tipo:	PSObject
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-AutoRelocateFile

Quando si specifica questa opzione, il cmdlet si occuperà di rilocare automaticamente tutti i file logici nel backup, a meno che tale file logico non venga specificato con l'oggetto RelocateFile. Il server DefaultFile e DefaultLog vengono usati per rilocare i file.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-BackupDevice

Specifica i dispositivi in cui vengono archiviati i backup. Questo parametro non può essere usato con il parametro BackupFile. Usare questo parametro se si esegue il backup in un dispositivo nastro.

Proprietà dei parametri

Tipo:	BackupDeviceItem[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-BackupFile

Specifica il percorso o i percorsi in cui vengono archiviati i file di backup. Questo parametro è facoltativo. Se non specificato, il percorso di backup predefinito del server viene cercato il nome <database name>.trn per i ripristini del log o <database name>.bak per tutti gli altri tipi di ripristini. Questo parametro non può essere usato con il parametro BackupDevice . Se si esegue il backup nel servizio archiviazione BLOB di Windows Azure (URL), è necessario specificare questo parametro o il parametro BackupDevice .

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	2
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-BlockSize

Specifica le dimensioni del blocco fisico, in byte, per il backup. Le dimensioni supportate sono 512, 1024, 2048, 4096, 8192, 16384, 32768 e 65536 (64 KB) byte. Il valore predefinito è 65536 per i dispositivi nastro e 512 per tutti gli altri dispositivi.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-BufferCount

Specifica il numero totale di buffer di I/O da usare per l'operazione di backup. È possibile specificare qualsiasi numero intero positivo. Se lo spazio degli indirizzi virtuali nel processo di Sqlservr.exe per i buffer non è sufficiente, si riceverà un errore di memoria insufficiente.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Checksum

Indica che un valore di checksum viene calcolato durante l'operazione di ripristino.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ClearSuspectPageTable

Indica che la tabella di pagine sospetta viene eliminata dopo l'operazione di ripristino.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ConnectionTimeout

Specifica il numero di secondi di attesa di una connessione server prima di un errore di timeout. Il valore di timeout deve essere un numero intero compreso tra 0 e 65534. Se si specifica 0, i tentativi di connessione non eseguono il timeout.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByName

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ContinueAfterError

Indica che l'operazione continua quando si verifica un errore di checksum. Se non impostato, l'operazione avrà esito negativo dopo un errore di checksum.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Credential

Specifica un oggetto PSCredential che contiene le credenziali per un account di accesso di SQL Server che dispone dell'autorizzazione per eseguire questa operazione.

Proprietà dei parametri

Tipo:	PSCredential
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByName

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Database

Specifica il nome del database da ripristinare. Non è possibile utilizzare questo parametro con il parametro DatabaseObject. Quando si usa questo parametro, è necessario specificare anche i parametri Path, InputObject o ServerInstance .

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByPath

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

ByName

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

ByObject

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DatabaseFile

Specifica i file di database di destinazione dell'operazione di ripristino. Viene utilizzato solo quando il parametro RestoreAction è impostato su Files. Quando il parametro RestoreAction è impostato su Files, è necessario specificare anche il parametro DatabaseFileGroups o DatabaseFiles .

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DatabaseFileGroup

Specifica i filegroup di database di destinazione dell'operazione di ripristino. Viene usato solo quando il parametro RestoreAction è impostato su File. Quando il parametro RestoreAction è impostato su Files, è necessario specificare anche il parametro DatabaseFileGroups o DatabaseFiles .

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DatabaseObject

Specifica un oggetto di database per l'operazione di ripristino.

Proprietà dei parametri

Tipo:	Database
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByDBObject

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Encrypt

Tipo di crittografia da usare per la connessione a SQL Server.

Questo valore esegue il Encrypt mapping alla proprietà SqlConnectionEncryptOption nell'oggetto SqlConnection del driver Microsoft.Data.SqlClient.

Nella versione 22 del modulo, l'impostazione predefinita è Optional (per compatibilità con v21). Nella versione 23+ del modulo, il valore predefinito sarà "Obbligatorio", che potrebbe creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	Mandatory, Optional, Strict
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-FileNumber

Specifica il numero di indice utilizzato per identificare il set di backup di destinazione nel supporto di backup.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-HostNameInCertificate

Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Forza crittografia e si vuole connettersi a un'istanza usando nome host/nome breve. Se questo parametro viene omesso, è necessario passare il nome di dominio completo (FQDN) a -ServerInstance per connettersi a un'istanza di SQL Server abilitata per Forza crittografia.

Questo parametro è nuovo nella versione 22 del modulo.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-InputObject

Specifica l'oggetto server dell'istanza di SQL Server in cui viene eseguito il ripristino.

Proprietà dei parametri

Tipo:	Server[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByObject

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-KeepReplication

Indica che la configurazione della replica viene mantenuta. Se non è impostata, la configurazione della replica viene ignorata dall'operazione di ripristino.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-MaxTransferSize

Specifica il numero massimo di byte da trasferire tra il supporto di backup e l'istanza di SQL Server. I valori possibili sono multipli di 65536 byte (64 KB), fino a 4194304 byte (4 MB).

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-MediaName

Specifica il nome che identifica un set di supporti.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-NoRecovery

Indica che il database viene ripristinato nello stato di ripristino. Un'operazione di rollback non viene eseguita e è possibile ripristinare backup aggiuntivi.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-NoRewind

Indica che un'unità nastro viene lasciata aperta alla posizione finale al termine del ripristino. Se non è impostato, il nastro viene riavvolto dopo il completamento dell'operazione. Questo non si applica ai ripristini del disco.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Offset

Specifica gli indirizzi di pagina da ripristinare. Questa opzione viene utilizzata solo quando RestoreAction è impostato su OnlinePage.

Proprietà dei parametri

Tipo:	Int64[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Partial

Indica che l'operazione di ripristino è un ripristino parziale.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-PassThru

Indica che questo cmdlet restituisce l'oggetto Smo.Backup utilizzato per eseguire l'operazione di ripristino.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Path

Specifica il percorso dell'istanza di SQL Server in cui eseguire l'operazione di ripristino. Questo parametro è facoltativo. Se non specificato, viene utilizzata la posizione di lavoro corrente.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByPath

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RelocateFile

Specifica un elenco di oggetti file Smo.Relocate. Ogni oggetto è costituito da un nome di file di backup logico e da un percorso fisico del file system. Il ripristino sposta il database ripristinato nel percorso fisico specificato nel server di destinazione.

Proprietà dei parametri

Tipo:	RelocateFile[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ReplaceDatabase

Indica che viene creata una nuova immagine del database. In questo modo viene sovrascritto qualsiasi database esistente con lo stesso nome. Se non è impostata, l'operazione di ripristino avrà esito negativo quando nel server esiste già un database con tale nome.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Restart

Indica che questo cmdlet riprende un'operazione di ripristino parzialmente completata. Se non impostato, il cmdlet riavvia un'operazione di ripristino interrotta all'inizio del set di backup.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RestoreAction

Specifica il tipo di operazione di ripristino eseguita. I valori validi sono:

• Banca dati. Il database viene ripristinato.
• File. Vengono ripristinati uno o più file di dati. È necessario specificare il parametro DatabaseFile o DatabaseFileGroup.
• OnlinePage. Una pagina di dati viene ripristinata online in modo che il database rimanga disponibile per gli utenti.
• OnlineFiles. I file di dati vengono ripristinati online in modo che il database rimanga disponibile per gli utenti. È necessario specificare il parametro DatabaseFile o DatabaseFileGroup.
• Registro. Il log di traslazione viene ripristinato.

Proprietà dei parametri

Tipo:	RestoreActionType
Valore predefinito:	None
Valori accettati:	Database, Files, OnlinePage, OnlineFiles, Log
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RestrictedUser

Indica che l'accesso al database ripristinato è limitato al ruolo predefinito del database db_owner e ai ruoli predefiniti del server dbcreator e sysadmin.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Script

Indica che questo cmdlet restituisce uno script Transact-SQL che esegue l'operazione di ripristino.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ServerInstance

Specifica il nome di un'istanza di SQL Server. Questa istanza del server diventa la destinazione dell'operazione di ripristino.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByName

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-SqlCredential

Specifica un oggetto credenziali di SQL Server che archivia le informazioni di autenticazione. Se si esegue il backup nel servizio di archiviazione BLOB, è necessario specificare questo parametro. Le informazioni di autenticazione archiviate includono il nome dell'account di archiviazione e i valori della chiave di accesso associati. Non specificare questo parametro per disco o nastro.

Proprietà dei parametri

Tipo:	PSObject
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StandbyFile

Specifica il nome di un file di annullamento usato come parte della strategia di creazione dell'immagine per un'istanza di SQL Server.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StopAtMarkAfterDate

Specifica la data da utilizzare con il nome del contrassegno specificato dal parametro StopAtMarkName per determinare il punto di arresto dell'operazione di ripristino.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StopAtMarkName

Specifica la transazione contrassegnata in corrispondenza della quale arrestare l'operazione di ripristino. Viene usato con StopAtMarkAfterDate per determinare il punto di arresto dell'operazione di ripristino. I dati recuperati includono la transazione che contiene il contrassegno. Se il valore StopAtMarkAfterDate non è impostato, il ripristino si arresta al primo contrassegno con il nome specificato.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StopBeforeMarkAfterDate

Specifica la data da utilizzare con StopBeforeMarkName per determinare il punto di arresto dell'operazione di ripristino.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StopBeforeMarkName

Specifica la transazione contrassegnata prima della quale arrestare l'operazione di ripristino. Viene usato con StopBeforeMarkAfterDate per determinare il punto di arresto dell'operazione di ripristino.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ToPointInTime

Specifica l'endpoint per il ripristino del log del database. Questo vale solo quando RestoreAction è impostato su Log.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TrustServerCertificate

Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.

Nella versione 22 del modulo, l'impostazione predefinita è $true (per compatibilità con v21). Nella versione 23+ del modulo, il valore predefinito sarà "$false", che potrebbe creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-UnloadTapeAfter

Indica che il dispositivo nastro viene riavvolto e scaricato al termine dell'operazione. Se non è impostato, non viene effettuato alcun tentativo di riavvolgimento e scaricamento del supporto nastro. Questo non si applica ai backup del disco.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server

Specifica un valore SMO. Oggetto Server che descrive l'istanza di SQL Server in cui viene eseguita l'operazione di ripristino.

System.String

Collegamenti correlati

• Backup-SqlDatabase