Azure Data Box 是一个混合解决方案，可用于快速、方便、可靠地将本地数据导入 Azure 中。 请先将数据传输到 Microsoft 提供的具有 80 TB 可用容量的存储设备，然后再将设备寄回。 然后，此数据将上传到 Azure。
请先完成下述适用于 Data Box 服务和设备的配置先决条件，然后部署设备：
对于服务
在开始之前，请确保：
你的 Microsoft Azure 存储帐户具有访问凭据，如存储帐户名和访问密钥。
用于 Data Box 服务的订阅是下述类型之一：
确保你有订阅的所有者或参与者访问权限，以便创建设备订单。
对于设备
在开始之前，请确保：
- 应该将一个主机连接到数据中心网络。 Data Box 会从此计算机复制数据。 主机必须按照 Azure Data Box 系统要求中的说明运行支持的操作系统。
- 数据中心需要有高速网络。 强烈建议你至少建立一个 10-GbE 连接。 如果 10-GbE 连接不可用，则可使用 1-GbE 数据链路，但复制速度会受影响。
对于服务
在开始之前，请确保：
你的 Microsoft Azure 存储帐户具有访问凭据，如存储帐户名和访问密钥。
用于 Data Box 服务的订阅是下述类型之一：
确保你有订阅的所有者或参与者访问权限，以便创建设备订单。
对于设备
在开始之前，请确保：
- 应该将一个主机连接到数据中心网络。 Data Box 会从此计算机复制数据。 主机必须按照 Azure Data Box 系统要求中的说明运行支持的操作系统。
- 数据中心需要有高速网络。 强烈建议你至少建立一个 10-GbE 连接。 如果 10-GbE 连接不可用，则可使用 1-GbE 数据链路，但复制速度会受影响。
如果还没有 Azure 订阅，可以在开始前创建一个免费帐户。
可以登录到 Azure，然后采用以下两种方式之一运行 Azure CLI 命令：
- 可以安装 CLI 并在本地运行 CLI 命令。
- 可以在 Azure 门户的 Azure Cloud Shell 中运行 CLI 命令。
在教程中，我们通过 Windows PowerShell 使用 Azure CLI，但你可以自由选择其中任意一种方法。
对于 Azure CLI
在开始之前，请确保：
在本地安装 CLI
登录到 Azure
打开 Windows PowerShell 命令窗口，并使用 az login 命令登录到 Azure：
PS C:\Windows> az login
下面是成功登录时的输出：
You have logged in. Now let us find all the subscriptions to which you have access.
[
{
"cloudName": "AzureCloud",
"homeTenantId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"isDefault": true,
"managedByTenants": [],
"name": "My Subscription",
"state": "Enabled",
"tenantId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"user": {
"name": "gusp@contoso.com",
"type": "user"
}
}
]
安装 Azure Data Box CLI 扩展
在使用 Azure Data Box CLI 命令之前，需要安装扩展。 借助 Azure CLI 扩展，可访问尚未在核心 CLI 中提供的试验性的和预发布的命令。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
若要安装 Azure Data Box 的扩展，请运行以下命令：az extension add --name databox：
PS C:\Windows> az extension add --name databox
如果扩展安装成功，你将看到以下输出：
The installed extension 'databox' is experimental and not covered by customer support. Please use with discretion.
PS C:\Windows>
# az databox help
PS C:\Windows> az databox -h
Group
az databox
Subgroups:
job [Experimental] : Commands to manage databox job.
For more specific examples, use: az find "az databox"
Please let us know how we are doing: https://aka.ms/clihats
使用 Azure Cloud Shell
可以通过浏览器使用 Azure Cloud Shell（一个 Azure 托管的交互式 Shell 环境）来运行 CLI 命令。 Azure Cloud Shell 通过 Azure 服务支持 Bash 或 Windows PowerShell。 已预安装 Azure CLI 并将其配置为与帐户一起使用。 选择 Azure 门户右上角部分菜单上的“Cloud Shell”按钮：
该按钮会启动交互式 shell，可以使用它来运行本文中概述的步骤。
对于服务
在开始之前，请确保：
你的 Microsoft Azure 存储帐户具有访问凭据，如存储帐户名和访问密钥。
用于 Data Box 服务的订阅是下述类型之一：
确保你有订阅的所有者或参与者访问权限，以便创建设备订单。
对于设备
在开始之前，请确保：
- 应该将一个主机连接到数据中心网络。 Data Box 会从此计算机复制数据。 主机必须按照 Azure Data Box 系统要求中的说明运行支持的操作系统。
- 数据中心需要有高速网络。 强烈建议你至少建立一个 10-GbE 连接。 如果 10-GbE 连接不可用，则可使用 1-GbE 数据链路，但复制速度会受影响。
对于 Azure PowerShell
在开始之前，请确保：
- 安装 Windows PowerShell 6.2.4 或更高版本。
- 安装 Azure PowerShell (AZ) 模块。
- 安装 Azure Data Box (Az.DataBox) 模块。
- 登录 Azure。
本地安装 Azure PowerShell 和模块
安装或升级 Windows PowerShell
需要安装 Windows PowerShell 6.2.4 或更高版本。 若要查看已安装的 PowerShell 版本，请运行：$PSVersionTable。
输出如下：
PS C:\users\gusp> $PSVersionTable
Name Value
---- -----
PSVersion 6.2.3
PSEdition Core
GitCommitId 6.2.3
OS Microsoft Windows 10.0.18363
Platform Win32NT
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
WSManStackVersion 3.0
如果你的版本低于 6.2.4，则需要升级 Windows PowerShell 版本。 要安装最新版本的 Windows PowerShell，请参阅安装 Azure PowerShell。
安装 Azure PowerShell 和 Data Box 模块
需要安装 Azure PowerShell 模块才能使用 Azure PowerShell 订购 Azure Data Box。 安装 Azure PowerShell 模块：
- 安装 Azure PowerShell Az 模块。
- 然后使用命令
Install-Module -Name Az.DataBox 安装 Az.DataBox。
PS C:\PowerShell\Modules> Install-Module -Name Az.DataBox
PS C:\PowerShell\Modules> Get-InstalledModule -Name "Az.DataBox"
Version Name Repository Description
------- ---- ---------- -----------
0.1.1 Az.DataBox PSGallery Microsoft Azure PowerShell - DataBox ser…
登录 Azure
打开 Windows PowerShell 命令窗口，并使用 Connect-AzAccount 命令登录到 Azure：
PS C:\Windows> Connect-AzAccount
下面是成功登录时的输出：
WARNING: To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code FSBFZMBKC to authenticate.
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
gusp@contoso.com MySubscription aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa AzureCloud
PS C:\Windows\System32>
有关如何使用 Windows PowerShell 登录到 Azure 的详细信息，请参阅使用 Azure PowerShell 进行登录。
下单后，可以从 Azure 门户跟踪订单状态。 转到你的 Data Box 订单，然后转到“概述”来查看状态。 门户中会显示订单处于“已订购”状态。
如果设备缺货，你会收到通知。 如果设备有货，Microsoft 会确定要发货的设备，并准备发货。 在设备准备期间，会执行以下操作：
- 将为与设备关联的每个存储帐户创建 SMB 共享。
- 将为每个共享生成访问凭据（例如用户名和密码）。
- 也会生成用于解锁设备的设备密码。
- 锁定 Data Box 的目的是在任何时候防止对设备进行未经授权的访问。
设备准备完成后，门户会显示订单处于“已处理”状态。
然后，Microsoft 会安排区域承运人发运设备。 设备发货后，你会收到跟踪号。 门户会显示订单处于“已发运”状态。
跟踪单个订单
若要获取单个现有 Azure Data Box 订单的跟踪信息，请运行 az databox job show。 该命令显示有关订单的信息，例如（但不限于）：名称、资源组、跟踪信息、订阅 ID、联系人信息、寄送类型和设备 sku。
az databox job show --resource-group <resource-group> --name <order-name>
下表显示 az databox job show 的参数信息：
| 参数 |
说明 |
示例值 |
| resource-group [必填] |
与订单关联的资源组的名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| 名称[必填] |
要显示的订单的名称。 |
"mydataboxorder" |
| debug |
在详细日志记录中包含调试信息 |
--debug |
| help |
显示此命令的帮助信息。 |
--help -h |
| only-show-errors |
只显示错误，取消显示警告。 |
--only-show-errors |
| output -o |
设置输出格式。 允许的值：json、jsonc、none、table、tsv、yaml、yamlc。 默认值是 json。 |
--output "json" |
| query |
JMESPath 查询字符串。 有关详细信息，请参阅 JMESPath。 |
--query <string> |
| verbose |
包括详细日志记录。 |
--verbose |
以下是输出格式设置为“table”的命令示例：
PS C:\WINDOWS\system32> az databox job show --resource-group "myresourcegroup" \
--name "mydataboxtest4" \
--output "table"
以下是运行命令后得到的输出：
Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
DeliveryType IsCancellable IsCancellableWithoutFee IsDeletable IsShippingAddressEditable Location Name ResourceGroup StartTime Status
-------------- --------------- ------------------------- ------------- --------------------------- ---------- -------------- --------------- -------------------------------- -------------
NonScheduled True True False True westus mydataboxtest4 myresourcegroup 2020-06-18T03:48:00.905893+00:00 DeviceOrdered
注意
可以在订阅级别支持列出订单，这使资源组成为可选参数（而不是必需参数）。
列出所有订单
如果订购了多台设备，可以运行 az databox job list 查看所有 Azure Data Box 订单。 该命令列出属于特定资源组的所有订单。 输出中还显示：订单名称、寄送状态、Azure 区域、交付类型、订单状态。 已取消的订单也包含在列表中。
此命令还显示每个订单的时间戳。
az databox job list --resource-group <resource-group>
下表显示 az databox job list 的参数信息：
| 参数 |
说明 |
示例值 |
| resource-group [必填] |
包含该订单的资源组名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| debug |
在详细日志记录中包含调试信息 |
--debug |
| help |
显示此命令的帮助信息。 |
--help -h |
| only-show-errors |
只显示错误，取消显示警告。 |
--only-show-errors |
| output -o |
设置输出格式。 允许的值：json、jsonc、none、table、tsv、yaml、yamlc。 默认值是 json。 |
--output "json" |
| query |
JMESPath 查询字符串。 有关详细信息，请参阅 JMESPath。 |
--query <string> |
| verbose |
包括详细日志记录。 |
--verbose |
以下是输出格式设置为“table”的命令示例：
PS C:\WINDOWS\system32> az databox job list --resource-group "GDPTest" --output "table"
以下是运行命令后得到的输出：
Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
CancellationReason DeliveryType IsCancellable IsCancellableWithoutFee IsDeletable IsShippingAddressEditable Location Name ResourceGroup StartTime Status
---------------------- ---------------------------------------- -------------- --------------- ------------------------- ------------- --------------------------- ---------- ------------------- --------------- -------------------------------- -------------
OtherReason This was a test order for documentation purposes. NonScheduled False False True False westus gdpImportTest MyResGrp 2020-05-26T23:20:57.464075+00:00 Cancelled
NoLongerNeeded This order was created for documentation purposes.NonScheduled False False True False westus mydataboxExportTest MyResGrp 2020-05-27T00:04:16.640397+00:00 Cancelled
IncorrectOrder NonScheduled False False True False westus mydataboxtest2 MyResGrp 2020-06-10T16:54:23.509181+00:00 Cancelled
NonScheduled True True False True westus mydataboxtest3 MyResGrp 2020-06-11T22:05:49.436622+00:00 DeviceOrdered
NonScheduled True True False True westus mydataboxtest4 MyResGrp 2020-06-18T03:48:00.905893+00:00 DeviceOrdered
PS C:\WINDOWS\system32>
跟踪单个订单
若要获取单个现有 Azure Data Box 订单的跟踪信息，请运行 Get-AzDataBoxJob。 该命令显示有关订单的信息，例如（但不限于）：名称、资源组、跟踪信息、订阅 ID、联系人信息、寄送类型和设备 sku。
注意
Get-AzDataBoxJob 用于显示单个和多个订单。 不同之处在于，为单个订单指定了订单名称。
Get-AzDataBoxJob -ResourceGroupName <String> -Name <String>
下表显示 Get-AzDataBoxJob 的参数信息：
| 参数 |
说明 |
示例值 |
| ResourceGroup [必填] |
与订单关联的资源组的名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| 名称[必填] |
要获取其信息的订单名称。 |
"mydataboxorder" |
| ResourceId |
与订单关联的资源的 ID。 |
|
下面是包含输出的命令示例：
PS C:\WINDOWS\system32> Get-AzDataBoxJob -ResourceGroupName "myResourceGroup" -Name "myDataBoxOrderPSTest"
以下是运行命令后得到的输出：
jobResource.Name jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
---------------- -------------------- ------------------ --------------------- -------------------- -------------
myDataBoxOrderPSTest DataBox DeviceOrdered 7/7/2020 12:37:16 AM WestUS myResourceGroup
列出所有订单
如果订购了多台设备，可以运行 Get-AzDataBoxJob 查看所有 Azure Data Box 订单。 该命令列出属于特定资源组的所有订单。 输出中还显示：订单名称、寄送状态、Azure 区域、交付类型、订单状态。 已取消的订单也包含在列表中。
此命令还显示每个订单的时间戳。
Get-AzDataBoxJob -ResourceGroupName <String>
下面是该命令的示例：
PS C:\WINDOWS\system32> Get-AzDataBoxJob -ResourceGroupName "myResourceGroup"
以下是运行命令后得到的输出：
jobResource.Name jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
---------------- -------------------- ------------------ --------------------- -------------------- -------------
guspImportTest DataBox Cancelled 5/26/2020 11:20:57 PM WestUS myResourceGroup
mydataboxExportTest DataBox Cancelled 5/27/2020 12:04:16 AM WestUS myResourceGroup
mydataboximport1 DataBox Cancelled 6/26/2020 11:00:34 PM WestUS myResourceGroup
myDataBoxOrderPSTest DataBox Cancelled 7/07/2020 12:37:16 AM WestUS myResourceGroup
mydataboxtest2 DataBox Cancelled 6/10/2020 4:54:23 PM WestUS myResourceGroup
mydataboxtest4 DataBox DeviceOrdered 6/18/2020 3:48:00 AM WestUS myResourceGroup
PS C:\WINDOWS\system32>
若要取消此订单，请在 Azure 门户中转到“概览”，然后在命令栏中选择“取消” 。
下单后，只要订单状态尚未标记为“已处理”，就可以随时取消订单。
若要删除已取消的订单，请转到“概况”，然后在命令栏中选择“删除” 。
取消订单
若要取消 Azure Data Box 订单，请运行 az databox job cancel。 你需要指定取消订单的原因。
az databox job cancel --resource-group <resource-group> --name <order-name> --reason <cancel-description>
下表显示 az databox job cancel 的参数信息：
| 参数 |
说明 |
示例值 |
| resource-group [必填] |
与要删除的订单关联的资源组的名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| 名称[必填] |
要删除的订单的名称。 |
"mydataboxorder" |
| 原因[必填] |
取消订单的原因。 |
“我输入了错误信息，需要取消订单。” |
| 是 |
不提示确认。 |
--yes (-y) |
| debug |
在详细日志记录中包含调试信息 |
--debug |
| help |
显示此命令的帮助信息。 |
--help -h |
| only-show-errors |
只显示错误，取消显示警告。 |
--only-show-errors |
| output -o |
设置输出格式。 允许的值：json、jsonc、none、table、tsv、yaml、yamlc。 默认值是 json。 |
--output "json" |
| query |
JMESPath 查询字符串。 有关详细信息，请参阅 JMESPath。 |
--query <string> |
| verbose |
包括详细日志记录。 |
--verbose |
下面是包含输出的命令示例：
PS C:\Windows> az databox job cancel --resource-group "myresourcegroup" --name "mydataboxtest3" --reason "Our budget was slashed due to **redacted** and we can no longer afford this device."
以下是运行命令后得到的输出：
Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
Are you sure you want to perform this operation? (y/n): y
PS C:\Windows>
删除订单
取消 Azure Data Box 订单后，可以运行 az databox job delete 删除订单。
az databox job delete --name [-n] <order-name> --resource-group <resource-group> [--yes] [--verbose]
下表显示 az databox job delete 的参数信息：
| 参数 |
说明 |
示例值 |
| resource-group [必填] |
与要删除的订单关联的资源组的名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| 名称[必填] |
要删除的订单的名称。 |
"mydataboxorder" |
| 订阅 |
Azure 订阅的名称或 ID (GUID)。 |
"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" |
| 是 |
不提示确认。 |
--yes (-y) |
| debug |
在详细日志记录中包含调试信息 |
--debug |
| help |
显示此命令的帮助信息。 |
--help -h |
| only-show-errors |
只显示错误，取消显示警告。 |
--only-show-errors |
| output -o |
设置输出格式。 允许的值：json、jsonc、none、table、tsv、yaml、yamlc。 默认值是 json。 |
--output "json" |
| query |
JMESPath 查询字符串。 有关详细信息，请参阅 JMESPath。 |
--query <string> |
| verbose |
包括详细日志记录。 |
--verbose |
下面是包含输出的命令示例：
PS C:\Windows> az databox job delete --resource-group "myresourcegroup" --name "mydataboxtest3" --yes --verbose
以下是运行命令后得到的输出：
Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
command ran in 1.142 seconds.
PS C:\Windows>
取消订单
若要取消 Azure Data Box 订单，请运行 Stop-AzDataBoxJob。 你需要指定取消订单的原因。
Stop-AzDataBoxJob -ResourceGroup <String> -Name <String> -Reason <String>
下表显示 Stop-AzDataBoxJob 的参数信息：
| 参数 |
说明 |
示例值 |
| ResourceGroup [必填] |
与要取消的订单关联的资源组的名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| 名称[必填] |
要删除的订单的名称。 |
"mydataboxorder" |
| 原因[必填] |
取消订单的原因。 |
“我输入了错误信息，需要取消订单。” |
| Force |
强制 cmdlet 在未经用户确认的情况下运行。 |
-Force |
下面是包含输出的命令示例：
PS C:\PowerShell\Modules> Stop-AzDataBoxJob -ResourceGroupName myResourceGroup \
-Name "myDataBoxOrderPSTest" \
-Reason "I entered erroneous information and had to cancel."
以下是运行命令后得到的输出：
Confirm
"Cancelling Databox Job "myDataBoxOrderPSTest
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
PS C:\WINDOWS\system32>
删除订单
如果取消了 Azure Data Box 订单，可以运行 Remove-AzDataBoxJob 删除订单。
Remove-AzDataBoxJob -Name <String> -ResourceGroup <String>
下表显示 Remove-AzDataBoxJob 的参数信息：
| 参数 |
说明 |
示例值 |
| ResourceGroup [必填] |
与要删除的订单关联的资源组的名称。 资源组是可以统一管理或部署的资源的逻辑容器。 |
"myresourcegroup" |
| 名称[必填] |
要删除的订单的名称。 |
"mydataboxorder" |
| Force |
强制 cmdlet 在未经用户确认的情况下运行。 |
-Force |
下面是包含输出的命令示例：
PS C:\Windows> Remove-AzDataBoxJob -ResourceGroup "myresourcegroup" \
-Name "mydataboxtest3"
以下是运行命令后得到的输出：
Confirm
"Removing Databox Job "mydataboxtest3
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
PS C:\Windows>
