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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by consistently presenting PowerShell examples and instructions before Azure CLI, and by providing detailed PowerShell command usage. PowerShell, a Windows-centric tool, is highlighted as a primary automation method, which may disadvantage Linux users. There are no Linux shell-specific examples (e.g., Bash), and the documentation does not mention Linux tools or patterns. While Azure CLI is cross-platform, the ordering and emphasis favor Windows/PowerShell users.
Recommendations:
- Alternate the order of PowerShell and Azure CLI sections, or present Azure CLI first to reflect its cross-platform nature.
- Explicitly mention that Azure CLI commands can be run on Linux, macOS, and Windows, and provide example shell environments (e.g., Bash, zsh).
- Add Bash script examples for common workflows, especially for automation scenarios.
- Clarify that PowerShell Core is available cross-platform, but note that most Linux users will prefer Azure CLI or Bash.
- Where screenshots or UI references are provided, ensure they are not Windows-specific (e.g., avoid showing only Windows-style terminals).
- Consider including a brief section on using REST API directly, which is platform-agnostic.
Create pull request
Flagged Code Snippets
$range = New-AzStorageBlobRangeToRestore -StartRange container1/d `
-EndRange container1/g
# Set resource group and account variables.
$rgName = "<resource-group>"
$accountName = "<storage-account>"
# Enable blob soft delete with a retention of 14 days.
Enable-AzStorageBlobDeleteRetentionPolicy -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-RetentionDays 14
# Enable change feed and versioning.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-EnableChangeFeed $true `
-IsVersioningEnabled $true
# Enable point-in-time restore with a retention period of 7 days.
# The retention period for point-in-time restore must be at least
# one day less than that set for soft delete.
Enable-AzStorageBlobRestorePolicy -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-RestoreDays 7
# View the service settings.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
-StorageAccountName $accountName
# Specify -TimeToRestore as a UTC value
$restoreOperation = Restore-AzStorageBlobRange -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-TimeToRestore (Get-Date).ToUniversalTime().AddHours(-12)
# Get the status of the restore operation.
$restoreOperation.Status
# Get the ID for the restore operation.
$restoreOperation.RestoreId
# Get the restore point in UTC time.
$restoreOperation.Parameters.TimeToRestore
Restore-AzStorageBlobRange -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-TimeToRestore (Get-Date).AddHours(-12) -WaitForComplete
$range = New-AzStorageBlobRangeToRestore -StartRange container1 `
-EndRange container2
# Specify -TimeToRestore as a UTC value
Restore-AzStorageBlobRange -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-BlobRestoreRange $range `
-TimeToRestore (Get-Date).AddDays(-3)
# Specify a range that includes the complete contents of container1.
$range1 = New-AzStorageBlobRangeToRestore -StartRange container1 `
-EndRange container2
# Specify a range that includes the complete contents of container4.
$range2 = New-AzStorageBlobRangeToRestore -StartRange container4 `
-EndRange container5
$restoreOperation = Restore-AzStorageBlobRange -ResourceGroupName $rgName `
-StorageAccountName $accountName `
-TimeToRestore (Get-Date).AddHours(-24) `
-BlobRestoreRange @($range1, $range2)
# Get the status of the restore operation.
$restoreOperation.Status
# Get the ID for the restore operation.
$restoreOperation.RestoreId
# Get the blob ranges specified for the operation.
$restoreOperation.Parameters.BlobRanges