Test-AzKustoClusterNameAvailability

  • Referência
Módulo:
Az.Kusto

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

Syntax

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 sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IKustoIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

O nome da região do Azure.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nome do cluster.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

A ID da assinatura de destino.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

IKustoIdentity

Saídas

ICheckNameResult