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_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation exclusively uses Azure PowerShell (Az module) commands and examples, which are most commonly associated with Windows environments. There are no examples or guidance for using equivalent Azure CLI commands, Bash scripts, or Linux-native tools. The prerequisites and all operational steps assume PowerShell usage, which may disadvantage Linux or cross-platform users.
Recommendations:
- Provide equivalent Azure CLI examples for all operations (create, list, update, delete event subscriptions), as Azure CLI is cross-platform and widely used on Linux and macOS.
- Explicitly mention that PowerShell Core is available on Linux and macOS, if PowerShell must be used, and provide installation instructions for non-Windows platforms.
- Add Bash script examples or note how to adapt the commands for Bash/Unix shells where appropriate.
- Reorganize the documentation to present cross-platform (CLI) solutions first or alongside PowerShell, rather than PowerShell-only instructions.
- Update the prerequisites to include installation instructions for Azure CLI and/or PowerShell Core on Linux/macOS.
Create pull request
Flagged Code Snippets
PS C:\> Install-Module Az.EventGrid
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$includedEventTypes = "Microsoft.Communication.SMSReceived", "Microsoft.Communication.SMSDeliveryReportReceived"
New-AzEventGridSubscription
-EndpointType webhook
-Endpoint https://azureeventgridviewer.azurewebsites.net/api/updates
-EventSubscriptionName EventsWebhookSubscription
-IncludedEventType $includedEventTypes
-ResourceId "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Communication/CommunicationServices/<acsResourceName>"
Get-AzEventGridSubscription
-ResourceId "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Communication/CommunicationServices/<acsResourceName>"
$includedEventTypes = "Microsoft.Communication.SMSReceived", "Microsoft.Communication.SMSDeliveryReportReceived", "Microsoft.Communication.ChatMessageReceived"
Update-AzEventGridSubscription
-EventSubscriptionName ES2
-IncludedEventType $includedEventTypes
-ResourceId "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Communication/CommunicationServices/<acsResourceName>"
-Endpoint https://azureeventgridviewer2.azurewebsites.net/api/updates
-SubjectEndsWith "phoneNumber"
Get-AzResource
-ResourceId "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Communication/CommunicationServices/<acsResourceName>" | Remove-AzEventGridSubscription -EventSubscriptionName ES2