O Test-AzEventHubName é um cmdlet do módulo Azure PowerShell que permite verificar a disponibilidade de um nome de Event Hub dentro de um namespace específico no Azure. Este artigo fornece uma visão geral de como utilizar este cmdlet com exemplos práticos.

Exemplos:

1. Verificando a Disponibilidade de um Nome de Event Hub

   Para verificar se um nome específico de Event Hub está disponível em um namespace, você pode usar o seguinte script PowerShell:

   # Importa o módulo Az.EventHub
   Import-Module Az.EventHub
   
   # Autentica no Azure
   Connect-AzAccount
   
   # Define o nome do namespace e do Event Hub
   $namespaceName = "meuNamespace"
   $eventHubName = "meuEventHub"
   
   # Verifica a disponibilidade do nome do Event Hub
   $result = Test-AzEventHubName -ResourceGroupName "meuGrupoDeRecursos" -NamespaceName $namespaceName -Name $eventHubName
   
   if ($result.NameAvailable) {
      Write-Output "O nome '$eventHubName' está disponível."
   } else {
      Write-Output "O nome '$eventHubName' não está disponível. Motivo: $($result.Reason)"
   }

2. Automatizando a Verificação para Vários Nomes

   Se você precisar verificar a disponibilidade de vários nomes de Event Hub, pode usar um loop para automatizar o processo:

   # Lista de nomes de Event Hub a serem verificados
   $eventHubNames = @("eventHub1", "eventHub2", "eventHub3")
   
   # Define o nome do namespace
   $namespaceName = "meuNamespace"
   
   foreach ($eventHubName in $eventHubNames) {
      $result = Test-AzEventHubName -ResourceGroupName "meuGrupoDeRecursos" -NamespaceName $namespaceName -Name $eventHubName
   
      if ($result.NameAvailable) {
          Write-Output "O nome '$eventHubName' está disponível."
      } else {
          Write-Output "O nome '$eventHubName' não está disponível. Motivo: $($result.Reason)"
      }
   }

3. Integrando com um Script de Criação de Event Hub

   Você pode integrar a verificação de disponibilidade de nome com um script que cria um Event Hub, garantindo que o nome esteja disponível antes de tentar criar o recurso:

   # Define o nome do namespace e do Event Hub
   $namespaceName = "meuNamespace"
   $eventHubName = "meuNovoEventHub"
   
   # Verifica a disponibilidade do nome do Event Hub
   $result = Test-AzEventHubName -ResourceGroupName "meuGrupoDeRecursos" -NamespaceName $namespaceName -Name $eventHubName
   
   if ($result.NameAvailable) {
      # Cria o Event Hub se o nome estiver disponível
      New-AzEventHub -ResourceGroupName "meuGrupoDeRecursos" -NamespaceName $namespaceName -Name $eventHubName -MessageRetentionInDays 1 -PartitionCount 2
      Write-Output "Event Hub '$eventHubName' criado com sucesso."
   } else {
      Write-Output "O nome '$eventHubName' não está disponível. Motivo: $($result.Reason)"
   }

Conclusão

O cmdlet Test-AzEventHubName é uma ferramenta útil para garantir que os nomes de Event Hub que você deseja usar estejam disponíveis antes de tentar criar os recursos no Azure. Usando PowerShell, você pode facilmente verificar a disponibilidade de nomes e automatizar o processo para múltiplos nomes ou integrá-lo em scripts maiores para gerenciar seus recursos do Azure de forma eficiente.