Get-SqlBackupHistory
取得資料庫的相關備份資訊，並根據這個 Cmdlet 指定的參數傳回每個備份記錄的 SMO BackupSet 物件。
Syntax
Get-SqlBackupHistory
[-Since <SinceType>]
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-BackupType <BackupSetType>]
[-IncludeSnapshotBackups]
[-TimeSpan <TimeSpan>]
[-IgnoreProviderContext]
[-SuppressProviderContextWarning]
[[-Path] <String[]>]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-DatabaseName <System.Collections.Generic.List`1[System.String]>]
[<CommonParameters>] Get-SqlBackupHistory
[-Since <SinceType>]
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-BackupType <BackupSetType>]
[-IncludeSnapshotBackups]
[-TimeSpan <TimeSpan>]
[-IgnoreProviderContext]
[-SuppressProviderContextWarning]
[[-ServerInstance] <String[]>]
[-Credential <PSCredential>]
[-ConnectionTimeout <Int32>]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-DatabaseName <System.Collections.Generic.List`1[System.String]>]
[<CommonParameters>] Get-SqlBackupHistory
[-Since <SinceType>]
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-BackupType <BackupSetType>]
[-IncludeSnapshotBackups]
[-TimeSpan <TimeSpan>]
[-IgnoreProviderContext]
[-SuppressProviderContextWarning]
[-InputObject] <Server[]>
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-DatabaseName <System.Collections.Generic.List`1[System.String]>]
[<CommonParameters>] Description
此 Cmdlet 會搜尋伺服器實例，並以 SMO BackupSet 物件的形式取得備份記錄，以取得符合指定參數的所有記錄。
範例
範例 1
PS C:\> Get-SqlBackupHistory -ServerInstance test-server -DatabaseName AdventureWorks2014
Name Type Backup Start Date Backup Finish Date
---- ---- ----------------- ------------------
AdventureWorks2014-Full Database Backup Database 2/21/2017 7:52:39 PM 2/21/2017 7:52:40 PM
AdventureWorks2014-Full Database Backup Database 3/20/2017 2:41:39 PM 3/20/2017 2:41:39 PM
AdventureWorks2014-Full-2017-07-24T22:22 Database 7/24/2017 3:23:11 PM 7/24/2017 3:23:11 PM此範例會取得測試伺服器 SQL 實例上 AdventureWorks2014 資料庫的所有備份類型記錄。
參數
-AccessToken
用來驗證 SQL Server 的存取令牌，作為使用者/密碼或 Windows 驗證的替代方案。
例如，這可用來連線至 SQL Azure DB 或使用 或使用 SQL Azure Managed InstanceService Principal 或 Managed Identity。
要使用的參數可以是字串，代表令牌或 PSAccessToken 執行 所傳 Get-AzAccessToken -ResourceUrl https://database.windows.net回的物件。
這個參數是模組 v22 的新功能。
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupType
要篩選的備份類型。 如果未指定，則取得所有備份類型。 接受的值定義如下。
| Type: | BackupSetType |
| Accepted values: | Database, Differential, Incremental, Log, FileOrFileGroup, FileOrFileGroupDifferential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionTimeout
要建立連接的等候時間，以及要填入動態產生的 -DatabaseName 參數。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
PSCredential 物件，其使用者名稱和密碼字段用來連線到 SQL 實例。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseName
要擷取其備份記錄的資料庫名稱。 這是動態填入的欄位，因此提供資料庫名稱的自動完成建議。
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Encrypt
連接到 SQL Server 時要使用的加密類型。
這個值會對應至 Encrypt Microsoft.Data.SqlClient 驅動程式之 SqlConnection 物件上的 屬性 SqlConnectionEncryptOption 。
在模組的 v22 中，預設值為 Optional (，以便與 v21) 相容。 在模組 v23+ 中，預設值會是「強制」，這可能會為現有的腳本建立重大變更。
這個參數是模組 v22 的新功能。
| Type: | String |
| Accepted values: | Mandatory, Optional, Strict |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndTime
要擷取的所有備份記錄都應該完成的時間。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostNameInCertificate
用於驗證 SQL Server TLS/SSL 憑證的主機名稱。 如果您的 SQL Server 實例已啟用強制加密，而且您想要使用主機名/簡短名稱連線到實例，則必須傳遞此參數。 如果省略此參數，則必須將完整域名 (FQDN) 傳遞至 -ServerInstance，才能連線到啟用強制加密的 SQL Server 實例。
這個參數是模組 v22 的新功能。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IgnoreProviderContext
指出這個 Cmdlet 不會使用目前的內容來覆寫 ServerInstance、 DatabaseName 參數的值。 如果您未指定此參數，Cmdlet 會盡可能忽略這些參數的值，而不是執行 Cmdlet 的內容。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeSnapshotBackups
此參數也會讓 Cmdlet 取得快照集備份的記錄。 根據預設，不會擷取這類備份。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定要取得備份記錄的 SMO Server 物件。
| Type: | Server[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
指定要用來取得BackupSets之伺服器實例或資料庫之伺服器實例或資料庫的SQL提供者路徑。 如果未指定，請使用目前的工作位置。
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServerInstance
此 Cmdlet 將鎖定的伺服器實例名稱。
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Since
指定您可以取代 StartTime 參數的縮寫。
您可以使用 EndTime 參數來指定它。
如果您使用此參數，則無法使用 StartTime 參數。
此參數可接受的值為：
- 午夜 (取得午夜) 之後產生的所有作業歷程記錄資訊
- 昨天 (取得過去 24 小時內產生的所有作業歷程記錄資訊)
- LastWeek (取得過去一周產生的所有作業歷程記錄資訊)
- LastMonth (取得上個月產生的所有作業歷程記錄資訊)
| Type: | SinceType |
| Accepted values: | Midnight, Yesterday, LastWeek, LastMonth |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartTime
取得在這段指定時間之後啟動的備份記錄。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuppressProviderContextWarning
當 Cmdlet 使用提供者內容時，隱藏警告。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeSpan
如果指定，它會導致 Cmdlet 篩選產生超過 『Timespan』 之前的記錄。
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrustServerCertificate
指出通道是否會在略過憑證鏈結以驗證信任時加密。
在模組的 v22 中，預設值為 $true (，以便與 v21) 相容。 在模組 v23+ 中，預設值會是 『$false』，這可能會為現有的腳本建立重大變更。
這個參數是模組 v22 的新功能。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
System.String[]
Microsoft.SqlServer.Management.Smo.Server[]
輸出
System.Object