通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-AzSqlDatabaseLongTermRetentionBackup

模块:
Az.Sql Module

获取一个或多个长期保留备份。

语法

Location （默认值） 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-Location] <String>
    [-ResourceGroupName <String>]
    [-OnlyLatestPerDatabase]
    [-DatabaseState <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServerName 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-Location] <String>
    [-ServerName] <String>
    [-DatabaseName <String>]
    [-ResourceGroupName <String>]
    [-OnlyLatestPerDatabase]
    [-DatabaseState <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BackupName 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-Location] <String>
    [-ServerName] <String>
    [-BackupName] <String>
    -DatabaseName <String>
    [-ResourceGroupName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

GetBackupByResourceId 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-Location] <String>
    [-ResourceId] <String>
    [-BackupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

GetBackupsByResourceId 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-Location] <String>
    [-ResourceId] <String>
    [-OnlyLatestPerDatabase]
    [-DatabaseState <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

GetBackupByInputObject 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-InputObject] <AzureSqlDatabaseModel>
    [-BackupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

GetBackupsByInputObject 

Get-AzSqlDatabaseLongTermRetentionBackup
    [-InputObject] <AzureSqlDatabaseModel>
    [-OnlyLatestPerDatabase]
    [-DatabaseState <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Get-AzSqlDatabaseLongTermRetentionBackup cmdlet 获取位置、服务器或数据库的所有长期保留备份，或获取特定的长期保留备份。

示例

示例 1：获取位置的所有备份

Get-AzSqlDatabaseLongTermRetentionBackup -Location northeurope

BackupExpirationTime			 : 3/22/2018 5:50:55 AM
BackupName						 : 601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
BackupTime						 : 3/15/2018 5:50:55 AM
DatabaseName					 : database01
DatabaseDeletionTime			 :
Location						 : northeurope
ResourceId						 : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/resourceGroups/resourcegroup01/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/database01/longTermRetentionBackups/601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
ServerName						 : server01
ServerCreateTime				 : 2/29/2018 12:12:19 AM
ResourceGroupName                :
BackupStorageRedundancy			 : Geo

BackupExpirationTime			 : 3/22/2018 11:43:18 PM
BackupName						 : 55970792-164c-4a4a-88e5-7158d092d503;131656309980000000
BackupTime						 : 3/15/2018 11:43:18 PM
DatabaseName					 : database02
DatabaseDeletionTime			 : 3/18/2018 4:36:00 PM
Location						 : northeurope
ResourceId						 : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server02/longTermRetentionDatabases/database02/longTermRetentionBackups/55970792-164c-4a4a-88e5-7158d092d503;131656309980000000
ServerName						 : server02
ServerCreateTime				 : 2/28/2018 12:12:19 AM
ResourceGroupName                :
BackupStorageRedundancy			 : Geo

此命令获取所有数据库（可能处于活动状态或删除）在东南部的所有长期保留备份，仅当服务器处于活动状态时，才会设置资源组。

示例 2：获取资源组下某个位置的所有备份

Get-AzSqlDatabaseLongTermRetentionBackup -Location northeurope -ResourceGroupName resourceGroup01

BackupExpirationTime			 : 3/22/2018 5:50:55 AM
BackupName						     : 601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
BackupTime						     : 3/15/2018 5:50:55 AM
DatabaseName					     : database01
DatabaseDeletionTime			 :
Location						       : northeurope
ResourceId						     : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/resourceGroups/resourcegroup01/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/database01/longTermRetentionBackups/601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
ServerName						     : server01
ServerCreateTime			  	 : 2/29/2018 12:12:19 AM
ResourceGroupName          : resourceGroup01
BackupStorageRedundancy		 : Geo

此命令获取 northeurope 资源组下所有数据库（可能处于活动状态或删除）的所有长期保留备份。

示例 3：获取特定的长期保留备份

Get-AzSqlDatabaseLongTermRetentionBackup -Location northeurope -ServerName server01 -DatabaseName database01 -BackupName "601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000"

BackupExpirationTime			 : 3/22/2018 5:50:55 AM
BackupName						     : 601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
BackupTime						     : 3/15/2018 5:50:55 AM
DatabaseName					     : database01
DatabaseDeletionTime			 :
Location						       : northeurope
ResourceId					       : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/resourceGroups/resourcegroup01/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/database01/longTermRetentionBackups/601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
ServerName						     : server01
ServerCreateTime			  	 : 2/29/2018 12:12:19 AM
ResourceGroupName          :
BackupStorageRedundancy		 : Geo

此命令获取名为 601061b7-d10b-46e0-bf77-a2bfb16a6add 的备份;131655666550000000

示例 4：获取数据库的所有长期保留备份

Get-AzSqlDatabase -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 | Get-AzSqlDatabaseLongTermRetentionBackup

BackupExpirationTime			 : 3/22/2018 5:50:55 AM
BackupName						     : 601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
BackupTime						     : 3/15/2018 5:50:55 AM
DatabaseName					     : database01
DatabaseDeletionTime			 :
Location						       : northeurope
ResourceId						     : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/resourceGroups/resourcegroup01/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/database01/longTermRetentionBackups/601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
ServerName						     : server01
ServerCreateTime				   : 2/29/2018 12:12:19 AM
ResourceGroupName          :
BackupStorageRedundancy		 : Geo

此命令获取 database01 的所有长期保留备份

示例 5：使用筛选获取长期保留备份

Get-AzSqlDatabaseLongTermRetentionBackup -Location northeurope -ServerName server01 -DatabaseName database01 -BackupName "601061b7*"

BackupExpirationTime			 : 3/22/2018 11:43:18 PM
BackupName					       : 601061b7-164c-4a4a-88e5-7158d092d503;131656309980000000
BackupTime						     : 3/15/2018 11:43:18 PM
DatabaseName					     : database02
DatabaseDeletionTime			 : 3/18/2018 4:36:00 PM
Location						       : northeurope
ResourceId					       : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/resourceGroups/resourcegroup01/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/database02/longTermRetentionBackups/601061b7-164c-4a4a-88e5-7158d092d503;131656309980000000
ServerName						     : server01
ServerCreateTime				   : 2/28/2018 12:12:19 AM
ResourceGroupName          :
BackupStorageRedundancy		 : Geo

BackupExpirationTime			 : 3/22/2018 5:50:55 AM
BackupName						     : 601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
BackupTime						     : 3/15/2018 5:50:55 AM
DatabaseName					     : database01
DatabaseDeletionTime			 :
Location						       : northeurope
ResourceId						     : /subscriptions/371edd6d-9630-4558-a7bd-ee139498e6a1/resourceGroups/resourcegroup01/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/database01/longTermRetentionBackups/601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
ServerName						     : server01
ServerCreateTime				   : 2/29/2018 12:12:19 AM
ResourceGroupName          :
BackupStorageRedundancy		 : Geo

此命令获取名称以“601061b7”开头的所有备份

参数

-BackupName

备份的名称。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

BackupName
Position:3
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
GetBackupByResourceId
Position:3
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
GetBackupByInputObject
Position:3
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DatabaseName

备份来自的 Azure SQL 数据库的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ServerName
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DatabaseState

要查找、活动、删除或全部备份的数据库的状态。 默认值为“全部”

参数属性

类型:String
默认值:None
接受的值:All, Deleted, Live
支持通配符:False
不显示:False

参数集

Location
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
ServerName
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
GetBackupsByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
GetBackupsByInputObject
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InputObject

要为其获取备份的数据库对象。

参数属性

类型:AzureSqlDatabaseModel
默认值:None
支持通配符:False
不显示:False

参数集

GetBackupByInputObject
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False
GetBackupsByInputObject
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Location

备份源服务器的位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Location
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
ServerName
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
BackupName
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
GetBackupByResourceId
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
GetBackupsByResourceId
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-OnlyLatestPerDatabase

是否仅获取每个数据库的最新备份。 默认值为 false。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

Location
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
ServerName
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
GetBackupsByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
GetBackupsByInputObject
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResourceGroupName

资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Location
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
ServerName
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
BackupName
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResourceId

要为其获取备份的数据库资源 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

GetBackupByResourceId
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
GetBackupsByResourceId
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ServerName

备份所依据的 Azure SQL Server 的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ServerName
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
BackupName
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

AzureSqlDatabaseModel

String

输出

AzureSqlDatabaseLongTermRetentionBackupModel