| title | description | services | author | ms.service | ms.subservice | ms.topic | ms.date | ms.author | ms.custom |
|---|---|---|---|---|---|---|---|---|---|
Tutorial to order Azure Data Box | Microsoft Docs |
In this tutorial, learn about Azure Data Box, a hybrid solution that allows you to import on-premises data into Azure, and how to order Azure Data Box. |
databox |
v-dalc |
databox |
pod |
tutorial |
03/22/2022 |
alkohli |
devx-track-azurepowershell, contperf-fy22q3, devx-track-azurecli |
Azure Data Box is a hybrid solution that allows you to import your on-premises data into Azure in a quick, easy, and reliable way. You transfer your data to a Microsoft-supplied storage device with 80 TB of usable capacity, and then ship the device back. This data is then uploaded to Azure.
This tutorial describes how you can order an Azure Data Box. In this tutorial, you learn about:
[!div class="checklist"]
- Prerequisites to deploy Data Box
- Order a Data Box
- Track the order
- Cancel the order
Note
To get answers to frequently asked questions about Data Box orders and shipments, see Data Box FAQ.
Complete the following configuration prerequisites for Data Box service and device before you deploy the device:
[!INCLUDE Prerequisites]
[!INCLUDE Prerequisites]
If you don't have an Azure subscription, create a free account before you begin.
You can sign in to Azure and run Azure CLI commands in one of two ways:
- You can install the CLI and run CLI commands locally.
- You can run CLI commands from within the Azure portal, in Azure Cloud Shell.
We use Azure CLI through Windows PowerShell for the tutorial, but you're free to choose either option.
Before you begin, make sure that:
- Install Azure CLI version 2.0.67 or later. Or install using MSI instead.
Sign in to Azure
Open up a Windows PowerShell command window and sign in to Azure with the az login command:
PS C:\Windows> az login
Here is the output from a successful sign-in:
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"
}
}
]
Install the Azure Data Box CLI extension
Before you can use the Azure Data Box CLI commands, you need to install the extension. Azure CLI extensions give you access to experimental and pre-release commands that haven't yet shipped as part of the core CLI. For more information about extensions, see Use extensions with Azure CLI.
To install the extension for Azure Data Box, run the following command: az extension add --name databox:
PS C:\Windows> az extension add --name databox
If the extension is installed successfully, you'll see the following output:
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
You can use Azure Cloud Shell, an Azure hosted interactive shell environment, through your browser to run CLI commands. Azure Cloud Shell supports Bash or Windows PowerShell with Azure services. The Azure CLI is pre-installed and configured to use with your account. Select the Cloud Shell button on the menu in the upper-right section of the Azure portal:
The button launches an interactive shell that you can use to run the steps outlined in this how-to article.
[!INCLUDE Prerequisites]
Before you begin, make sure that you:
- Install Windows PowerShell 6.2.4 or higher.
- Install Azure PowerShell (AZ) module.
- Install Azure Data Box (Az.DataBox) module.
- Sign in to Azure.
Install or upgrade Windows PowerShell
You'll need to have Windows PowerShell version 6.2.4 or higher installed. To find out what version of PowerShell is installed, run: $PSVersionTable.
You'll see the following output:
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
If your version is lower than 6.2.4, you need to upgrade your version of Windows PowerShell. To install the latest version of Windows PowerShell, see Install Azure PowerShell.
Install Azure PowerShell and Data Box modules
You'll need to install the Azure PowerShell modules to use Azure PowerShell to order an Azure Data Box. To install the Azure PowerShell modules:
- Install the Azure PowerShell Az module.
- Then install Az.DataBox using the command
Install-Module -Name 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…
Open up a Windows PowerShell command window and sign in to Azure with the Connect-AzAccount command:
PS C:\Windows> Connect-AzAccount
Here is the output from a successful sign-in:
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>
For detailed information on how to sign in to Azure using Windows PowerShell, see Sign in with Azure PowerShell.
[!INCLUDE order-data-box-via-portal]
Do the following steps using Azure CLI to order a device:
-
Write down your settings for your Data Box order. These settings include your personal/business information, subscription name, device information, and shipping information. You'll need to use these settings as parameters when running the CLI command to create the Data Box order. The following table shows the parameter settings used for
az databox job create:Setting (parameter) Description Sample value resource-group Use an existing or create a new one. A resource group is a logical container for the resources that can be managed or deployed together. "myresourcegroup" name The name of the order you're creating. "mydataboxorder" contact-name The name associated with the shipping address. "Gus Poland" phone The phone number of the person or business that will receive the order. "14255551234" location The nearest Azure region to you that will be shipping your device. "US West" sku The specific Data Box device you're ordering. Valid values are: "DataBox", "DataBoxDisk", and "DataBoxHeavy" "DataBox" email-list The email addresses associated with the order. "gusp@contoso.com" street-address1 The street address to where the order will be shipped. "15700 NE 39th St" street-address2 The secondary address information, such as apartment number or building number. "Building 123" city The city that the device will be shipped to. "Redmond" state-or-province The state where the device will be shipped. "WA" country The country that the device will be shipped. "United States" postal-code The zip code or postal code associated with the shipping address. "98052" company-name The name of your company you work for. "Contoso, LTD" storage account The Azure Storage account from where you want to import data. "mystorageaccount" debug Include debugging information to verbose logging --debug help Display help information for this command. --help -h only-show-errors Only show errors, suppressing warnings. --only-show-errors output -o Sets the output format. Allowed values: json, jsonc, none, table, tsv, yaml, yamlc. The default value is json. --output "json" query The JMESPath query string. For more information, see JMESPath. --query <string> verbose Include verbose logging. --verbose -
In your command-prompt of choice or terminal, run az data box job create to create your Azure Data Box order.
az databox job create --resource-group <resource-group> --name <order-name> --location <azure-location> --sku <databox-device-type> --contact-name <contact-name> --phone <phone-number> --email-list <email-list> --street-address1 <street-address-1> --street-address2 <street-address-2> --city "contact-city" --state-or-province <state-province> --country <country> --postal-code <postal-code> --company-name <company-name> --storage-account "storage-account"Here is an example of command usage:
az databox job create --resource-group "myresourcegroup" \ --name "mydataboxtest3" \ --location "westus" \ --sku "DataBox" \ --contact-name "Gus Poland" \ --phone "14255551234" \ --email-list "gusp@contoso.com" \ --street-address1 "15700 NE 39th St" \ --street-address2 "Bld 25" \ --city "Redmond" \ --state-or-province "WA" \ --country "US" \ --postal-code "98052" \ --company-name "Contoso" \ --storage-account mystorageaccountHere is the output from running the command:
Command group 'databox job' is experimental and not covered by customer support. Please use with discretion. { "cancellationReason": null, "deliveryInfo": { "scheduledDateTime": "0001-01-01T00:00:00+00:00" }, "deliveryType": "NonScheduled", "details": null, "error": null, "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Microsoft.DataBox/jobs/mydataboxtest3", "identity": { "type": "None" }, "isCancellable": true, "isCancellableWithoutFee": true, "isDeletable": false, "isShippingAddressEditable": true, "location": "westus", "name": "mydataboxtest3", "resourceGroup": "myresourcegroup", "sku": { "displayName": null, "family": null, "name": "DataBox" }, "startTime": "2020-06-10T23:28:27.354241+00:00", "status": "DeviceOrdered", "tags": {}, "type": "Microsoft.DataBox/jobs" } PS C:\Windows> -
All Azure CLI commands will use json as the output format by default unless you change it. You can change the output format by using the global parameter
--output <output-format>. Changing the format to "table" will improve output readability.Here is the same command we just ran with a small tweak to change the formatting:
az databox job create --resource-group "myresourcegroup" --name "mydataboxtest4" --location "westus" --sku "DataBox" --contact-name "Gus Poland" --phone "14255551234" --email-list "gusp@contoso.com" --street-address1 "15700 NE 39th St" --street-address2 "Bld 25" --city "Redmond" --state-or-province "WA" --country "US" --postal-code "98052" --company-name "Contoso" --storage-account mystorageaccount --output "table"Here is the output from running the command:
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
Do the following steps using Azure PowerShell to order a device:
-
Before you create the import order, you need to get your storage account and save the storage account object in a variable.
$storAcct = Get-AzStorageAccount -Name "mystorageaccount" -ResourceGroup "myresourcegroup" -
Write down your settings for your Data Box order. These settings include your personal/business information, subscription name, device information, and shipping information. You'll need to use these settings as parameters when running the PowerShell command to create the Data Box order. The following table shows the parameter settings used for New-AzDataBoxJob.
Setting (parameter) Description Sample value ResourceGroupName [Required] Use an existing resource group. A resource group is a logical container for the resources that can be managed or deployed together. "myresourcegroup" Name [Required] The name of the order you're creating. "mydataboxorder" ContactName [Required] The name associated with the shipping address. "Gus Poland" PhoneNumber [Required] The phone number of the person or business that will receive the order. "14255551234" Location [Required] The nearest Azure region to you that will be shipping your device. "WestUS" DataBoxType [Required] The specific Data Box device you're ordering. Valid values are: "DataBox", "DataBoxDisk", and "DataBoxHeavy" "DataBox" EmailId [Required] The email addresses associated with the order. "gusp@contoso.com" StreetAddress1 [Required] The street address to where the order will be shipped. "15700 NE 39th St" StreetAddress2 The secondary address information, such as apartment number or building number. "Building 123" StreetAddress3 The tertiary address information. City [Required] The city that the device will be shipped to. "Redmond" StateOrProvinceCode [Required] The state where the device will be shipped. "WA" CountryCode [Required] The country that the device will be shipped. "United States" PostalCode [Required] The zip code or postal code associated with the shipping address. "98052" CompanyName The name of your company you work for. "Contoso, LTD" StorageAccountResourceId [Required] The Azure Storage account ID from where you want to import data. <AzstorageAccount>.id -
In your command-prompt of choice or terminal, use the New-AzDataBoxJob to create your Azure Data Box order.
PS> $storAcct = Get-AzureStorageAccount -StorageAccountName "mystorageaccount" PS> New-AzDataBoxJob -Location "WestUS" \ -StreetAddress1 "15700 NE 39th St" \ -PostalCode "98052" \ -City "Redmond" \ -StateOrProvinceCode "WA" \ -CountryCode "US" \ -EmailId "gusp@contoso.com" \ -PhoneNumber 4255551234 \ -ContactName "Gus Poland" \ -StorageAccount $storAcct.id \ -DataBoxType DataBox \ -ResourceGroupName "myresourcegroup" \ -Name "myDataBoxOrderPSTest"Here is the output from running the command:
jobResource.Name jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup ---------------- -------------------- ------------------ --------------------- -------------------- ------------- myDataBoxOrderPSTest DataBox DeviceOrdered 07-06-2020 05:25:30 westus myresourcegroup
After you place the order, you can track the status of the order from Azure portal. Go to your Data Box order and then go to Overview to view the status. The portal shows the order in Ordered state.
If the device isn't available, you receive a notification. If the device is available, Microsoft identifies the device for shipment and prepares the shipment. During device preparation, following actions occur:
- SMB shares are created for each storage account associated with the device.
- For each share, access credentials such as username and password are generated.
- Device password that helps unlock the device is also generated.
- The Data Box is locked to prevent unauthorized access to the device at any point.
When the device preparation is complete, the portal shows the order in Processed state.
Microsoft then prepares and dispatches your device via a regional carrier. You receive a tracking number once the device is shipped. The portal shows the order in Dispatched state.
To get tracking information about a single, existing Azure Data Box order, run az databox job show. The command displays information about the order such as, but not limited to: name, resource group, tracking information, subscription ID, contact information, shipment type, and device sku.
az databox job show --resource-group <resource-group> --name <order-name>
The following table shows the parameter information for az databox job show:
| Parameter | Description | Sample value |
|---|---|---|
| resource-group [Required] | The name of the resource group associated with the order. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| name [Required] | The name of the order to be displayed. | "mydataboxorder" |
| debug | Include debugging information to verbose logging | --debug |
| help | Display help information for this command. | --help -h |
| only-show-errors | Only show errors, suppressing warnings. | --only-show-errors |
| output -o | Sets the output format. Allowed values: json, jsonc, none, table, tsv, yaml, yamlc. The default value is json. | --output "json" |
| query | The JMESPath query string. For more information, see JMESPath. | --query <string> |
| verbose | Include verbose logging. | --verbose |
Here is an example of the command with output format set to "table":
PS C:\WINDOWS\system32> az databox job show --resource-group "myresourcegroup" \
--name "mydataboxtest4" \
--output "table"
Here is the output from running the command:
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
Note
List order can be supported at subscription level and that makes resource group an optional parameter (rather than a required parameter).
If you have ordered multiple devices, you can run az databox job list to view all your Azure Data Box orders. The command lists all orders that belong to a specific resource group. Also displayed in the output: order name, shipping status, Azure region, delivery type, order status. Canceled orders are also included in the list.
The command also displays time stamps of each order.
az databox job list --resource-group <resource-group>
The following table shows the parameter information for az databox job list:
| Parameter | Description | Sample value |
|---|---|---|
| resource-group [Required] | The name of the resource group that contains the orders. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| debug | Include debugging information to verbose logging | --debug |
| help | Display help information for this command. | --help -h |
| only-show-errors | Only show errors, suppressing warnings. | --only-show-errors |
| output -o | Sets the output format. Allowed values: json, jsonc, none, table, tsv, yaml, yamlc. The default value is json. | --output "json" |
| query | The JMESPath query string. For more information, see JMESPath. | --query <string> |
| verbose | Include verbose logging. | --verbose |
Here is an example of the command with output format set to "table":
PS C:\WINDOWS\system32> az databox job list --resource-group "GDPTest" --output "table"
Here is the output from running the command:
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>
To get tracking information about a single, existing Azure Data Box order, run Get-AzDataBoxJob. The command displays information about the order such as, but not limited to: name, resource group, tracking information, subscription ID, contact information, shipment type, and device sku.
Note
Get-AzDataBoxJob is used for displaying both single and multiple orders. The difference is that you specify the order name for single orders.
Get-AzDataBoxJob -ResourceGroupName <String> -Name <String>
The following table shows the parameter information for Get-AzDataBoxJob:
| Parameter | Description | Sample value |
|---|---|---|
| ResourceGroup [Required] | The name of the resource group associated with the order. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| Name [Required] | The name of the order to get information for. | "mydataboxorder" |
| ResourceId | The ID of the resource associated with the order. |
Here is an example of the command with output:
PS C:\WINDOWS\system32> Get-AzDataBoxJob -ResourceGroupName "myResourceGroup" -Name "myDataBoxOrderPSTest"
Here is the output from running the command:
jobResource.Name jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
---------------- -------------------- ------------------ --------------------- -------------------- -------------
myDataBoxOrderPSTest DataBox DeviceOrdered 7/7/2020 12:37:16 AM WestUS myResourceGroup
If you have ordered multiple devices, you can run Get-AzDataBoxJob to view all your Azure Data Box orders. The command lists all orders that belong to a specific resource group. Also displayed in the output: order name, shipping status, Azure region, delivery type, order status. Canceled orders are also included in the list.
The command also displays time stamps of each order.
Get-AzDataBoxJob -ResourceGroupName <String>
Here is an example of the command:
PS C:\WINDOWS\system32> Get-AzDataBoxJob -ResourceGroupName "myResourceGroup"
Here is the output from running the command:
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>
To cancel this order, in the Azure portal, go to Overview and select Cancel from the command bar.
After placing an order, you can cancel it at any point before the order status is marked processed.
To delete a canceled order, go to Overview and select Delete from the command bar.
To cancel an Azure Data Box order, run az databox job cancel. You're required to specify your reason for canceling the order.
az databox job cancel --resource-group <resource-group> --name <order-name> --reason <cancel-description>
The following table shows the parameter information for az databox job cancel:
| Parameter | Description | Sample value |
|---|---|---|
| resource-group [Required] | The name of the resource group associated with the order to be deleted. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| name [Required] | The name of the order to be deleted. | "mydataboxorder" |
| reason [Required] | The reason for canceling the order. | "I entered erroneous information and needed to cancel the order." |
| yes | Do not prompt for confirmation. | --yes (-y) |
| debug | Include debugging information to verbose logging | --debug |
| help | Display help information for this command. | --help -h |
| only-show-errors | Only show errors, suppressing warnings. | --only-show-errors |
| output -o | Sets the output format. Allowed values: json, jsonc, none, table, tsv, yaml, yamlc. The default value is json. | --output "json" |
| query | The JMESPath query string. For more information, see JMESPath. | --query <string> |
| verbose | Include verbose logging. | --verbose |
Here is an example of the command with output:
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."
Here is the output from running the command:
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>
After you cancel an Azure Data Box order, you can run az databox job delete to delete the order.
az databox job delete --name [-n] <order-name> --resource-group <resource-group> [--yes] [--verbose]
The following table shows the parameter information for az databox job delete:
| Parameter | Description | Sample value |
|---|---|---|
| resource-group [Required] | The name of the resource group associated with the order to be deleted. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| name [Required] | The name of the order to be deleted. | "mydataboxorder" |
| subscription | The name or ID (GUID) of your Azure subscription. | "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" |
| yes | Do not prompt for confirmation. | --yes (-y) |
| debug | Include debugging information to verbose logging | --debug |
| help | Display help information for this command. | --help -h |
| only-show-errors | Only show errors, suppressing warnings. | --only-show-errors |
| output -o | Sets the output format. Allowed values: json, jsonc, none, table, tsv, yaml, yamlc. The default value is json. | --output "json" |
| query | The JMESPath query string. For more information, see JMESPath. | --query <string> |
| verbose | Include verbose logging. | --verbose |
Here is an example of the command with output:
PS C:\Windows> az databox job delete --resource-group "myresourcegroup" --name "mydataboxtest3" --yes --verbose
Here is the output from running the command:
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>
To cancel an Azure Data Box order, run Stop-AzDataBoxJob. You're required to specify your reason for canceling the order.
Stop-AzDataBoxJob -ResourceGroup <String> -Name <String> -Reason <String>
The following table shows the parameter information for Stop-AzDataBoxJob:
| Parameter | Description | Sample value |
|---|---|---|
| ResourceGroup [Required] | The name of the resource group associated with the order to be canceled. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| Name [Required] | The name of the order to be deleted. | "mydataboxorder" |
| Reason [Required] | The reason for canceling the order. | "I entered erroneous information and needed to cancel the order." |
| Force | Forces the cmdlet to run without user confirmation. | -Force |
Here is an example of the command with output:
PS C:\PowerShell\Modules> Stop-AzDataBoxJob -ResourceGroupName myResourceGroup \
-Name "myDataBoxOrderPSTest" \
-Reason "I entered erroneous information and had to cancel."
Here is the output from running the command:
Confirm
"Cancelling Databox Job "myDataBoxOrderPSTest
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
PS C:\WINDOWS\system32>
If you have canceled an Azure Data Box order, you can run Remove-AzDataBoxJob to delete the order.
Remove-AzDataBoxJob -Name <String> -ResourceGroup <String>
The following table shows the parameter information for Remove-AzDataBoxJob:
| Parameter | Description | Sample value |
|---|---|---|
| ResourceGroup [Required] | The name of the resource group associated with the order to be deleted. A resource group is a logical container for the resources that can be managed or deployed together. | "myresourcegroup" |
| Name [Required] | The name of the order to be deleted. | "mydataboxorder" |
| Force | Forces the cmdlet to run without user confirmation. | -Force |
Here is an example of the command with output:
PS C:\Windows> Remove-AzDataBoxJob -ResourceGroup "myresourcegroup" \
-Name "mydataboxtest3"
Here is the output from running the command:
Confirm
"Removing Databox Job "mydataboxtest3
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
PS C:\Windows>
In this tutorial, you learned about Azure Data Box articles such as:
[!div class="checklist"]
- Prerequisites to deploy Data Box
- Order Data Box
- Track the order
- Cancel the order
Advance to the next tutorial to learn how to set up your Data Box.
[!div class="nextstepaction"] Set up your Azure Data Box