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

Get-AzureRmBackupJob

  • 参考
模块:
AzureRM.Backup

获取备份作业。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

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 参数指定过去七天的时间。 该命令不指定 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 循环，该循环检查作业的当前状态，直到作业完成。 有关关键字 (keyword)时的信息，请键入 Get-Help about_While。 while 循环将消息写入控制台，睡眠 10 秒，然后更新$Job变量。 该脚本使用现有$Job值和当前 cmdlet 来更新$Job变量，以获取作业的当前状态。 有关 Windows PowerShell cmdlet 的信息，请键入 Get-Help Write-Host 和 Get-Help Start-Sleep。 脚本的最后一行告知脚本已完成。

参数

-DefaultProfile

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

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

-From

指定此 cmdlet 获取的作业的时间范围的开始日期（作为 DateTime 对象）。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。 有关 DateTime 对象的详细信息，请键入 Get-Help Get-Date。

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

-Job

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

Type:AzureRMBackupJob
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobId

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

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

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

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

-To

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

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

-Type

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

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

-Vault

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

Type:AzureRMBackupVault
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

AzureRMBackupVault

参数：保管库（ByValue）

输出

AzureRMBackupJob

备注

  • 无