Share via


New-AzImportExport

在指定的訂用帳戶中建立新的作業或更新現有的作業。

Syntax

New-AzImportExport
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-AcceptLanguage <String>]
   [-ClientTenantId <String>]
   [-BackupDriveManifest]
   [-BlobListBlobPath <String[]>]
   [-BlobListBlobPathPrefix <String[]>]
   [-CancelRequested]
   [-DeliveryPackageCarrierName <String>]
   [-DeliveryPackageDriveCount <Int64>]
   [-DeliveryPackageShipDate <String>]
   [-DeliveryPackageTrackingNumber <String>]
   [-DiagnosticsPath <String>]
   [-DriveList <IDriveStatus[]>]
   [-EncryptionKeyKekType <EncryptionKekType>]
   [-EncryptionKeyKekUrl <String>]
   [-EncryptionKeyKekVaultId <String>]
   [-ExportBlobListBlobPath <String>]
   [-IncompleteBlobListUri <String>]
   [-JobType <String>]
   [-Location <String>]
   [-LogLevel <String>]
   [-PercentComplete <Int64>]
   [-ProvisioningState <String>]
   [-ReturnAddressCity <String>]
   [-ReturnAddressCountryOrRegion <String>]
   [-ReturnAddressEmail <String>]
   [-ReturnAddressPhone <String>]
   [-ReturnAddressPostalCode <String>]
   [-ReturnAddressRecipientName <String>]
   [-ReturnAddressStateOrProvince <String>]
   [-ReturnAddressStreetAddress1 <String>]
   [-ReturnAddressStreetAddress2 <String>]
   [-ReturnPackageCarrierName <String>]
   [-ReturnPackageDriveCount <Int64>]
   [-ReturnPackageShipDate <String>]
   [-ReturnPackageTrackingNumber <String>]
   [-ReturnShippingCarrierAccountNumber <String>]
   [-ReturnShippingCarrierName <String>]
   [-ShippingInformationCity <String>]
   [-ShippingInformationCountryOrRegion <String>]
   [-ShippingInformationPhone <String>]
   [-ShippingInformationPostalCode <String>]
   [-ShippingInformationRecipientName <String>]
   [-ShippingInformationStateOrProvince <String>]
   [-ShippingInformationStreetAddress1 <String>]
   [-ShippingInformationStreetAddress2 <String>]
   [-State <String>]
   [-StorageAccountId <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

在指定的訂用帳戶中建立新的作業或更新現有的作業。

範例

範例 1:建立新的 ImportExport 作業

$driveList = @( @{ DriveId = "9CA995BA"; BitLockerKey = "238810-662376-448998-450120-652806-203390-606320-483076"; ManifestFile = "\\DriveManifest.xml"; ManifestHash = "109B21108597EF36D5785F08303F3638"; DriveHeaderHash = "" })
New-AzImportExport -Name test-job -ResourceGroupName ImportTestRG -Location eastus -StorageAccountId "/subscriptions/<SubscriptionId>/resourcegroups/ImportTestRG/providers/Microsoft.Storage/storageAccounts/teststorageforimport" -JobType Import -ReturnAddressRecipientName "Some name" -ReturnAddressStreetAddress1 "Street1" -ReturnAddressCity "Redmond" -ReturnAddressStateOrProvince "WA" -ReturnAddressPostalCode "98008" -ReturnAddressCountryOrRegion "USA" -ReturnAddressPhone "4250000000" -ReturnAddressEmail test@contoso.com -DiagnosticsPath "waimportexport" -BackupDriveManifest -DriveList $driveList

Location Name     Type
-------- ----     ----
eastus   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

預設值為 False。 指出磁片磁碟機上的資訊清單檔是否應該複製到區塊 Blob。

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

-BlobListBlobPath

Blob 路徑字串的集合。

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

-BlobListBlobPathPrefix

Blob 前置詞字串的集合。

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

-CancelRequested

指出是否已提交要求以取消作業。

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

-ClientTenantId

發出要求之用戶端的租使用者識別碼。

Type:String
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

-DiagnosticsPath

將儲存磁片磁碟機資訊清單檔案的複製記錄和備份的虛擬 Blob 目錄(如果已啟用的話)。

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

-EncryptionKeyKekType

kek 加密金鑰的類型

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

-EncryptionKeyKekUrl

指定 kek 加密金鑰的 URL。

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

-EncryptionKeyKekVaultId

指定 kek 加密金鑰的 keyvault 資源識別碼。

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

-ExportBlobListBlobPath

區塊 Blob 的相對 URI,其中包含上述定義的 Blob 路徑或 Blob 路徑前置詞清單,開頭為容器名稱。 如果 Blob 位於根容器中,URI 的開頭必須是 $root。

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

-IncompleteBlobListUri

指向區塊 Blob 的 Blob 路徑,其中包含由於磁片磁碟機空間不足而未匯出的 Blob 名稱清單。 如果已成功匯出所有 Blob,則回應中不會包含這個專案。

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

-JobType

作業的類型

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

-Location

指定應該在其中建立作業的支援 Azure 位置

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

-LogLevel

預設值為 Error。 指出是否啟用錯誤記錄或詳細資訊記錄。

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

-PercentComplete

作業完成的整體百分比。

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

-ProvisioningState

指定作業的布建狀態。

Type:String
Position:Named
Default value:None
Required:False
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

-ReturnPackageCarrierName

用來運送匯入或匯出磁片磁碟機的貨運公司名稱。

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

-ReturnPackageDriveCount

套件中包含的磁片磁碟機數目。

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

-ReturnPackageShipDate

套件出貨的日期。

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

-ReturnPackageTrackingNumber

封裝的追蹤編號。

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

-ShippingInformationCity

傳回磁片磁碟機時要使用的城市名稱。

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

-ShippingInformationCountryOrRegion

傳回磁片磁碟機時要使用的國家或地區。

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

-ShippingInformationPhone

電話所傳回磁片磁碟機的收件者數目。

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

-ShippingInformationPostalCode

傳回磁片磁碟機時要使用的郵遞區號。

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

-ShippingInformationRecipientName

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

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

-ShippingInformationStateOrProvince

傳回磁片磁碟機時要使用的州或省。

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

-ShippingInformationStreetAddress1

傳回磁片磁碟機時要使用的街道位址第一行。

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

-ShippingInformationStreetAddress2

傳回磁片磁碟機時要使用的街道位址第二行。

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

-State

作業的目前狀態。

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

-StorageAccountId

要匯入或匯出資料的儲存體帳戶資源識別碼。

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

輸出

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,其中包含資料傳輸作業的詳細資訊記錄檔。