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

Get-AzureRmBackupJob

获取备份作业。

重要

由于 Az PowerShell 模块现在已具有 AzureRM PowerShell 模块的所有功能及更多功能,因此我们将于 2024 年 2 月 29 日停用 AzureRM PowerShell 模块。

若要避免服务中断,请更新脚本,在 2024 年 2 月 29 日结束之前将使用 AzureRM PowerShell 模块的脚本更新为使用 Az PowerShell 模块。 若要自动更新脚本,请按照快速入门指南操作。

语法

Get-AzureRmBackupJob
   -Vault <AzureRMBackupVault>
   [-JobId <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Status <String>]
   [-Type <String>]
   [-Operation <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmBackupJob
   -Job <AzureRMBackupJob>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzureRmBackupJob cmdlet 获取特定保管库的Azure 备份作业。

示例

示例 1:获取备份保管库中的所有作业

PS C:\>$Vault = Get-AzureRmBackupVault -Name "Vault03"
PS C:\> Get-AzureRmBackupJob -Vault $Vault
WorkloadName    Operation       Status          StartTime              EndTime
------------    ---------       ------          ---------              -------
co03-vm         Backup          InProgress      26-Aug-15 12:24:01 PM  01-Jan-01 12:00:00 AM
co03-vm         ConfigureBackup Completed       26-Aug-15 12:19:49 PM  26-Aug-15 12:19:54 PM
co03-vm         Register        Completed       25-Aug-15 3:23:53 PM   25-Aug-15 3:25:00 PM

第一个命令使用 Get-AzureRmBackupVault cmdlet 获取名为 Vault03 的保管库。 该命令将该对象存储在$Vault变量中。 第二个命令获取$Vault中保管库的所有作业。

示例 2:获取已完成的作业

PS C:\>Get-AzureRmBackupJob -Vault $Vault -Status Completed
WorkloadName    Operation       Status          StartTime              EndTime
------------    ---------       ------          ---------              -------
co03-vm         Register        Completed       25-Aug-15 3:23:53 PM   25-Aug-15 3:25:00 PM

此命令从 $Vault 中的保管库中获取已完成的作业。

示例 3:获取上周失败的作业

PS C:\>Get-AzureRmBackupJob -Vault $Vault -From (Get-Date).AddDays(-7) -Status Failed

此命令从$Vault保管库获取上周失败的作业。 From 参数指定过去 7 天的时间。 该命令不指定 To 参数的值。 因此,它使用当前时间的默认值。

示例 4:轮询已完成的正在进行的作业的备份

PS C:\>$Jobs = Get-AzureRmBackupJob -Vault $Vault -Status InProgress
$Job = $Jobs[0] 
while ( $Job.Status -ne Completed ) 
{
   Write-Host "Waiting for completion..." 
   Start-Sleep -Seconds 10
   $job = Get-AzureRmBackupJob -Vault $Vault -Job $Job
}
Write-Host "Done!"
Waiting for completion... 
Waiting for completion... 
Waiting for completion... 
Done!

此脚本轮询当前正在进行的第一个作业,直到作业完成。 脚本的第一行获取正在进行的$Vault中的所有作业,然后将这些作业存储在$Jobs数组变量中。 第二行将$Jobs数组中的第一个作业存储在$Job变量中。 第三行启动 一个 while 循环,该循环检查作业的当前状态,直到作业完成。 有关 while 关键字的信息,请键入 Get-Help about_Whilewhile 循环将消息写入控制台,休眠 10 秒,然后更新$Job变量。 该脚本使用现有$Job值和当前 cmdlet 更新$Job变量,以获取作业的当前状态。 有关 Windows PowerShell cmdlet 的信息,请键入Get-Help Write-HostGet-Help Start-Sleep。 脚本的最后一行会告诉你脚本已完成。

参数

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-From

指定此 cmdlet 获取的作业的时间范围的 start(作为 DateTime 对象)。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。 有关 DateTime 对象的详细信息,请键入 Get-Help Get-Date

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Job

指定此 cmdlet 获取的作业。 若要获取 AzureRmBackupJob 对象,请使用 Get-AzureRmBackupJob cmdlet。

Type:Microsoft.Azure.Commands.AzureBackup.Models.AzureRMBackupJob
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-JobId

指定此 cmdlet 获取的作业的 ID。 ID 是 AzureRmBackupJob 对象的 InstanceId 属性。 若要获取 AzureRmBackupJob 对象,请使用 Get-AzureRmBackupJob。

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

-Operation

指定此 cmdlet 获取的作业的操作。 此参数的可接受值为:

  • 备份
  • ConfigureBackup
  • DeleteBackupData
  • 注册
  • 还原
  • UnProtect
  • 注销
Type:String
Accepted values:Backup, ConfigureBackup, DeleteBackupData, Register, Restore, UnProtect, Unregister
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Status

指定此 cmdlet 获取的作业的状态。 此参数的可接受值为:

  • 正在进行
  • 失败
  • 已取消
  • Cancelling
  • 已完成
  • CompletedWithWarnings 可以指定此参数来查找所有正在进行的作业或所有失败的作业。
Type:String
Accepted values:Cancelled, Cancelling, Completed, CompletedWithWarnings, Failed, InProgress
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-To

指定此 cmdlet 获取的作业的时间范围的结束(作为 DateTime 对象)。 默认值为当前系统时间。 如果指定此参数,还必须指定 From 参数。

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Type

指定此 cmdlet 为其获取备份作业的容器的类型。 目前,唯一支持的值是 AzureVM。

Type:String
Accepted values:AzureVM
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Vault

指定此 cmdlet 为其获取作业的备份保管库。 若要获取 AzureRmBackupVault 对象,请使用 Get-AzureRmBackupVault cmdlet。

Type:Microsoft.Azure.Commands.AzureBackup.Models.AzureRMBackupVault
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

输入

Microsoft.Azure.Commands.AzureBackup.Models.AzureRMBackupVault

参数:Vault (ByValue)

输出

Microsoft.Azure.Commands.AzureBackup.Models.AzureRMBackupJob

备注