Test-AzKustoClusterNameAvailability

模組:

Az.Kusto

檢查叢集名稱是否有效，且尚未使用中。

Syntax

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

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

Description

檢查叢集名稱是否有效，且尚未使用中。

範例

範例 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 叢集是否存在於 “East US” 區域中。

範例 2：檢查未使用中之 Kusto 叢集名稱的可用性

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

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

上述命令會傳回 「availablekustocluster」 的 Kusto 叢集是否存在於 「美國東部」區域中。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

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

-InputObject

Identity Parameter To construct， see NOTES section for INPUTOBJECT properties and create a hash table.

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

-Location

Azure 區域的名稱。

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

-Name

叢集名稱。

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

-SubscriptionId

目標訂用帳戶的標識碼。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

IKustoIdentity

輸出

ICheckNameResult