Compartilhar via


Test-AzKustoClusterNameAvailability

Verifica se o nome do cluster é válido e ainda não está em uso.

Sintaxe

Test-AzKustoClusterNameAvailability
    -Location <String>
    [-SubscriptionId <String>]
    -Name <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-AzKustoClusterNameAvailability
    -InputObject <IKustoIdentity>
    -Name <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Verifica se o nome do cluster é válido e ainda não está em uso.

Exemplos

Exemplo 1: verificar a disponibilidade de um nome de cluster Kusto que está em uso

Test-AzKustoClusterNameAvailability -Name testnewkustocluster -Location 'East US'

Message                                                                                       Name                NameAvailable Reason
-------                                                                                       ----                ------------- ------
Name 'testnewkustocluster' with type Engine is already taken. Please specify a different name testnewkustocluster False

O comando acima retorna se existe ou não um cluster Kusto chamado "testnewkustocluster" na região "Leste dos EUA".

Exemplo 2: verificar a disponibilidade de um nome de cluster Kusto que não está em uso

Test-AzKustoClusterNameAvailability -Name availablekustocluster -Location 'East US'

Message Name                  NameAvailable Reason
------- ----                  ------------- ------
        availablekustocluster True

O comando acima retorna se existe ou não um cluster Kusto chamado "availablekustocluster" na região "Leste dos EUA".

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTES para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:IKustoIdentity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

O nome da região do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Nome do cluster.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubscriptionId

A ID da assinatura de destino.

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

IKustoIdentity

Saídas

ICheckNameResult