Restore-SqlDatabase

Modulo:

SQLPS 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[]>]
    [-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]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-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]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-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]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

Restore-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-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]
    [-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 l'intero database MainDB dal file \\mainserver\databasebackup\MainDB.bak all'istanza del server Computer\Istanza.

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 del server Computer\Istanza.

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 l'intero database MainDB dal file \\mainserver\databasebackup\MainDB.trn all'istanza del server Computer\Istanza, usando l'account di accesso SA 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 del server 'Computer\Instance'.

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 "Nov 11, 2011 11:11 AM"

Questo comando ripristina il log delle transazioni del database MainDB fino alla data passata al parametro ToPointInTime , 11 novembre 2011 11:11.

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 l'intero database MainDB nell'istanza del server Computer\Istanza e 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 nell'istanza del server Computer\Istanza. 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 l'intero database MainDB dal file nel servizio archiviazione BLOB di Windows Azure all'istanza del server Computer\Istanza.

Parametri

-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 del database.trn> per i ripristini del log o <il nome> del database.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:	3
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:	2
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

ByObject

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

ByName

Posizione:	2
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:	2
Obbligatorio:	True
Valore dalla pipeline:	True
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

-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 operazione viene utilizzata solo quando il parametro 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 .
• Registro. Il log di traslazione viene ripristinato.
• 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 .

Proprietà dei parametri

Tipo:	RestoreActionType
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

-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 il parametro 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 il parametro 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 il parametro 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 il parametro 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

-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

Smo.Server

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

Collegamenti correlati

• Backup-SqlDatabase