About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
β οΈ
windows_first
β οΈ
powershell_heavy
β οΈ
windows_tools
β οΈ
missing_linux_example
Summary:
The documentation exhibits a notable Windows bias. PowerShell and Windows-specific instructions are given prominence, with command prompts and output examples consistently referencing Windows environments (e.g., 'PS C:\Windows>'). Installation steps and prerequisites focus on Windows PowerShell, and there is little to no mention of Linux or macOS equivalents for local CLI or PowerShell usage. Even when discussing Azure CLI, the examples and screenshots are Windows-centric, and there are no explicit Linux terminal examples or guidance for non-Windows users.
Recommendations:
- Provide explicit Linux (and optionally macOS) examples for Azure CLI usage, including sample commands and expected output in a bash shell (e.g., '$ az login').
- When referencing installation steps for CLI or PowerShell, include links and instructions for Linux and macOS, not just Windows (e.g., 'Install Azure CLI on Linux').
- Avoid using Windows PowerShell as the default or only terminal in CLI examples; alternate or parallel examples in bash should be included.
- Where output paths or prompts are shown (e.g., 'PS C:\Windows>'), provide equivalent bash prompt examples (e.g., '$'), or use generic prompts.
- Clarify that Azure PowerShell can be used cross-platform (with PowerShell Core), and provide installation and usage instructions for Linux/macOS.
- Add a section or note explicitly addressing Linux/macOS users, outlining any differences or considerations for those platforms.
Create pull request
Flagged Code Snippets
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
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
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β¦
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>
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>
Get-AzDataBoxJob -ResourceGroupName <String> -Name <String>
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 -ResourceGroupName <String>
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>
Stop-AzDataBoxJob -ResourceGroupName myResourceGroup \
-Name "myDataBoxOrderPSTest" \
-Reason "I entered erroneous information and need to cancel and re-order."
Confirm
"Cancelling Databox Job "myDataBoxOrderPSTest
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
Remove-AzDataBoxJob -ResourceGroup "myresourcegroup" \
-Name "mydataboxtest3"
Confirm
"Removing Databox Job "mydataboxtest3
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
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/[GUID]/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>
$storAcct = Get-AzStorageAccount -Name "mystorageaccount" -ResourceGroup "myresourcegroup"
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"
jobResource.Name jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
---------------- -------------------- ------------------ --------------------- -------------------- -------------
myDataBoxOrderPSTest DataBox DeviceOrdered 07-06-2020 05:25:30 westus myresourcegroup
PS C:\WINDOWS\system32> az databox job show --resource-group "myresourcegroup" \
--name "mydataboxtest4" \
--output "table"