Test-AzKustoClusterNameAvailability

モジュール:

Az.Kusto

クラスター名が有効であり、まだ使用されていないことを確認します。

構文

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

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

説明

クラスター名が有効であり、まだ使用されていないことを確認します。

例

例 1: 使用中の Kusto クラスター名の可用性を確認する

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

上記のコマンドは、"testnewkustocluster" という名前の Kusto クラスターが "米国東部" リージョンに存在するかどうかを返します。

例 2: 使用中ではない Kusto クラスター名の可用性を確認する

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

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

上記のコマンドは、"availablekustocluster" という名前の Kusto クラスターが "米国東部" リージョンに存在するかどうかを返します。

パラメーター

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

ID パラメーターを構築するには、INPUTOBJECT プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:	IKustoIdentity
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Location

Azure リージョンの名前。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

クラスター名。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubscriptionId

ターゲット サブスクリプションの ID。

型:	String
配置:	Named
規定値:	(Get-AzContext).Subscription.Id
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

IKustoIdentity

出力

ICheckNameResult