O cmdlet Test-AzKustoManagedPrivateEndpointNameAvailability é uma ferramenta específica do módulo Az.Kusto no Azure PowerShell. Ele serve para verificar se o nome que você deseja dar a um Managed Private Endpoint (Ponto de Extremidade Privado Gerenciado) está disponível para uso dentro de um cluster específico do Azure Data Explorer (Kusto).
Isso é essencial para evitar falhas em scripts de automação de infraestrutura (IaC) antes de tentar criar o recurso de fato.
🛠️ 1. Preparação: Instalando o Módulo
Como este comando faz parte do ecossistema Azure, você precisa garantir que o módulo Az.Kusto esteja instalado no seu Windows.
No PowerShell (como Administrador), execute:
PowerShell
# Instala o módulo Az.Kusto
Install-Module -Name Az.Kusto -AllowClobber -Scope CurrentUser
# Conecta na sua conta do Azure
Connect-AzAccount
🔍 2. Entendendo o Fluxo do Private Endpoint
Antes de rodar o comando, é bom entender onde esse “nome” se encaixa. O Managed Private Endpoint permite que seu cluster Kusto se conecte de forma privada a outros recursos do Azure (como um SQL Server ou Storage Account) sem passar pela internet pública.
⌨️ 3. Como Usar o Cmdlet
A sintaxe básica exige o nome do cluster, o grupo de recursos e o nome que você quer testar.
PowerShell
Test-AzKustoManagedPrivateEndpointNameAvailability `
-ClusterName "meuclusterkusto" `
-ResourceGroupName "meu-rg-producao" `
-Name "mpe-conexao-sql-segura"
Parâmetros Principais:
-ClusterName: O nome do seu cluster Kusto (Azure Data Explorer).-ResourceGroupName: O grupo de recursos onde o cluster está hospedado.-Name: O nome que você pretende validar (deve seguir as regras de nomenclatura do Azure: letras, números e hifens).
📊 4. Interpretando o Resultado
O retorno deste comando é um objeto que contém duas propriedades principais:
| Propriedade | Significado |
Name | O nome que você testou. |
Available | Retorna True se você pode usar o nome, ou False se já estiver ocupado. |
Message | Se Available for falso, explica o motivo (ex: nome inválido ou já em uso). |
🚀 5. Exemplo Prático em Script de Automação
Se você estiver criando um script para provisionar infraestrutura, pode usar o if para garantir que o processo só continue se o nome estiver livre:
PowerShell
$check = Test-AzKustoManagedPrivateEndpointNameAvailability -ClusterName "kustoprod" -ResourceGroupName "rg-data" -Name "mpe-storage-01"
if ($check.NameAvailable) {
Write-Host "O nome está disponível! Prosseguindo com a criação..." -ForegroundColor Green
# Aqui entraria o comando New-AzKustoManagedPrivateEndpoint
} else {
Write-Warning "Erro: $($check.Message)"
}
[!NOTE]
Lembre-se que nomes de Managed Private Endpoints devem ser únicos dentro do contexto do cluster. Dois clusters diferentes podem ter endpoints com o mesmo nome, mas o mesmo cluster não.
- Como usar o cmdlet Test-AzKustoManagedPrivateEndpointNameAvailability no PowerShell no Window
- Como converter arquivos de mídia no Windows usando ferramentas de linha de comando
- Script para desligar o Wi-Fi e impedir a conexão por 30 segundos no Linux
- Descubra como usar o Xbox Insider Hub no Windows.
- Como configurar seu microfone no Windows: um guia passo a passo
