Test-AzKustoDatabaseNameAvailability

  • Referência
Módulo:
Az.Kusto

Verifica se o nome do recurso de bancos de dados é válido e ainda não está em uso.

Syntax

Test-AzKustoDatabaseNameAvailability
    -ClusterName <String>
    -ResourceGroupName <String>
    -Name <String>
    -Type <Type>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]
Test-AzKustoDatabaseNameAvailability
    -InputObject <IKustoIdentity>
    -Name <String>
    -Type <Type>
    [-DefaultProfile <PSObject>]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Description

Verifica se o nome do recurso de bancos de dados é válido e ainda não está em uso.

Exemplos

Exemplo 1: Verificar a disponibilidade de um nome de banco de dados Kusto que está em uso

Test-AzKustoDatabaseNameAvailability -ResourceGroupName testrg -ClusterName testnewkustocluster -Name mykustodatabase -Type Microsoft.Kusto/Clusters/Databases

Message                                                                                                          Name            NameAvailable Reason
-------                                                                                                          ----            ------------- ------
Database mykustodatabase already exists in cluster testnewkustocluster. Please select a different database name. mykustodatabase False

O comando acima retorna se existe ou não um banco de dados Kusto chamado "mykustodatabase" no cluster "testnewkustocluster".

Exemplo 2: Verificar a disponibilidade de um nome de banco de dados Kusto que não está em uso

Test-AzKustoDatabaseNameAvailability -ResourceGroupName testrg -ClusterName testnewkustocluster -Name mykustodatabase2 -Type Microsoft.Kusto/Clusters/Databases

Message Name             NameAvailable Reason
------- ----             ------------- ------
        mykustodatabase2 True

O comando acima retorna se um banco de dados Kusto chamado "mykustodatabase2" existe ou não no cluster "testnewkustocluster".

Parâmetros

-ClusterName

O nome do cluster Kusto.

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

-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

-Name

Nome do recurso.

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

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

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

-Type

O tipo de recurso, por exemplo, Microsoft.Kusto/Clusters/databases.

Type:Type
Position:Named
Default value:None
Required:True
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