Share via


Update-AzImportExport

更新 作業的特定屬性。 您可以呼叫此作業,以通知 匯入/匯出 服務,包含匯入或匯出作業的硬碟已運送至 Microsoft 數據中心。 它也可以用來取消現有的作業。

Syntax

Update-AzImportExport
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AcceptLanguage <String>]
      [-BackupDriveManifest]
      [-CancelRequested]
      [-DeliveryPackageCarrierName <String>]
      [-DeliveryPackageDriveCount <Int64>]
      [-DeliveryPackageShipDate <String>]
      [-DeliveryPackageTrackingNumber <String>]
      [-DriveList <IDriveStatus[]>]
      [-LogLevel <String>]
      [-ReturnAddressCity <String>]
      [-ReturnAddressCountryOrRegion <String>]
      [-ReturnAddressEmail <String>]
      [-ReturnAddressPhone <String>]
      [-ReturnAddressPostalCode <String>]
      [-ReturnAddressRecipientName <String>]
      [-ReturnAddressStateOrProvince <String>]
      [-ReturnAddressStreetAddress1 <String>]
      [-ReturnAddressStreetAddress2 <String>]
      [-ReturnShippingCarrierAccountNumber <String>]
      [-ReturnShippingCarrierName <String>]
      [-State <String>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Update-AzImportExport
      -InputObject <IImportExportIdentity>
      [-AcceptLanguage <String>]
      [-BackupDriveManifest]
      [-CancelRequested]
      [-DeliveryPackageCarrierName <String>]
      [-DeliveryPackageDriveCount <Int64>]
      [-DeliveryPackageShipDate <String>]
      [-DeliveryPackageTrackingNumber <String>]
      [-DriveList <IDriveStatus[]>]
      [-LogLevel <String>]
      [-ReturnAddressCity <String>]
      [-ReturnAddressCountryOrRegion <String>]
      [-ReturnAddressEmail <String>]
      [-ReturnAddressPhone <String>]
      [-ReturnAddressPostalCode <String>]
      [-ReturnAddressRecipientName <String>]
      [-ReturnAddressStateOrProvince <String>]
      [-ReturnAddressStreetAddress1 <String>]
      [-ReturnAddressStreetAddress2 <String>]
      [-ReturnShippingCarrierAccountNumber <String>]
      [-ReturnShippingCarrierName <String>]
      [-State <String>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

更新 作業的特定屬性。 您可以呼叫此作業,通知 匯入/匯出 服務,包含匯入或匯出作業的硬碟已運送至 Microsoft 數據中心。 它也可以用來取消現有的作業。

範例

範例 1:依資源群組和伺服器名稱更新 ImportExport 作業

Update-AzImportExport -Name test-job -ResourceGroupName ImportTestRG -DeliveryPackageCarrierName pwsh -DeliveryPackageTrackingNumber pwsh20200000

Location Name     Type
-------- ----     ----
East US  test-job Microsoft.ImportExport/jobs

此 Cmdlet 會依資源群組和伺服器名稱更新 ImportExport 作業。

範例 2:依身分識別更新 ImportExport 作業。

Get-AzImportExport -Name test-job -ResourceGroupName ImportTestRG | Update-AzImportExport -CancelRequested

Location Name     Type
-------- ----     ----
East US  test-job Microsoft.ImportExport/jobs

此 Cmdlet 會依身分識別更新 ImportExport 作業。

參數

-AcceptLanguage

指定回應的慣用語言。

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

-BackupDriveManifest

指出磁碟驅動器上的指令清單檔是否應該複製到區塊 Blob。

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

-CancelRequested

如果指定,則值必須為 true。 服務會嘗試取消作業。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-DeliveryPackageCarrierName

用來運送匯入或匯出磁碟驅動器的貨運公司名稱。

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

-DeliveryPackageDriveCount

套件中包含的磁碟驅動器數目。

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

-DeliveryPackageShipDate

套件出貨的日期。

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

-DeliveryPackageTrackingNumber

封裝的追蹤編號。

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

-DriveList

組成作業的磁碟驅動器清單。 若要建構,請參閱 DRIVELIST 屬性的 NOTES 區段並建立哈希表。

Type:IDriveStatus[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-LogLevel

指出是否啟用錯誤記錄或詳細信息記錄。

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

-Name

匯入/匯出作業的名稱。

Type:String
Aliases:JobName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

資源組名可唯一識別使用者訂用帳戶內的資源群組。

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

-ReturnAddressCity

傳回磁碟驅動器時要使用的城市名稱。

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

-ReturnAddressCountryOrRegion

傳回磁碟驅動器時要使用的國家或地區。

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

-ReturnAddressEmail

所傳回磁碟驅動器收件者的電子郵件位址。

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

-ReturnAddressPhone

電話 所傳回磁碟驅動器的收件者數目。

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

-ReturnAddressPostalCode

傳回磁碟驅動器時要使用的郵遞區號編碼。

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

-ReturnAddressRecipientName

傳回硬碟時接收硬碟的收件者名稱。

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

-ReturnAddressStateOrProvince

傳回磁碟驅動器時要使用的州或省。

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

-ReturnAddressStreetAddress1

傳回磁碟驅動器時要使用的街道位址第一行。

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

-ReturnAddressStreetAddress2

傳回磁碟驅動器時要使用的街道位址第二行。

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

-ReturnShippingCarrierAccountNumber

客戶的帳戶號碼與貨運公司。

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

-ReturnShippingCarrierName

貨運公司的名稱。

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

-State

如果指定,此值必須是 Shipping,它會告訴 匯入/匯出 服務作業的套件已出貨。 ReturnAddress 和 DeliveryPackage 屬性必須在此要求或先前的要求中設定,否則要求將會失敗。

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

-SubscriptionId

Azure 使用者的訂用帳戶標識碼。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

指定將指派給作業的標記。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

IImportExportIdentity

輸出

IJobResponse

備註

別名

COMPLEX PARAMETER PROPERTIES

若要建立以下所述的參數,請建構包含適當屬性的哈希表。 如需哈希表的相關信息,請執行 Get-Help about_Hash_Tables。

DRIVELIST <IDriveStatus[]>:組成作業的磁碟驅動器清單。

  • [BitLockerKey <String>]:用來加密磁碟驅動器的 BitLocker 金鑰。
  • [BytesSucceeded <Int64?>]:已成功傳輸磁碟驅動器的位元組。
  • [CopyStatus <String>]:數據傳輸程式的詳細狀態。 此欄位不會在回應中傳回,直到磁碟驅動器處於傳輸狀態為止。
  • [DriveHeaderHash <String>]:磁碟驅動器標頭哈希值。
  • [DriveId <String>]:磁碟驅動器的硬體序號,不含空格。
  • [ErrorLogUri <String>]:指向 Blob 的 URI,其中包含資料傳輸作業的錯誤記錄檔。
  • [ManifestFile <String>]:磁碟驅動器上指令清單檔的相對路徑。
  • [ManifestHash <String>]:磁碟驅動器上指令清單檔的Base16編碼 MD5 哈希。
  • [ManifestUri <String>]:指向包含磁碟驅動器指令清單檔案之 Blob 的 URI。
  • [PercentComplete <Int64?>]:磁碟驅動器已完成的百分比。
  • [State <DriveState?>]:磁碟驅動器的目前狀態。
  • [VerboseLogUri <String>]:指向 Blob 的 URI,其中包含資料傳輸作業的詳細資訊記錄檔。

INPUTOBJECT <IImportExportIdentity>:Identity 參數

  • [Id <String>]:資源識別路徑
  • [JobName <String>]:匯入/匯出作業的名稱。
  • [LocationName <String>]:位置的名稱。 例如,美國西部或 westus。
  • [ResourceGroupName <String>]:資源組名可唯一識別使用者訂用帳戶內的資源群組。
  • [SubscriptionId <String>]:Azure 使用者的訂用帳戶標識碼。