Test-AzKustoDatabaseNameAvailability

  • 參考
模組:
Az.Kusto

檢查資料庫資源名稱是否有效，且尚未使用中。

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

檢查資料庫資源名稱是否有效，且尚未使用中。

範例

範例 1：檢查正在使用中的 Kusto 資料庫名稱可用性

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

上述命令會傳回 「mykustodatabase」 的 Kusto 資料庫是否存在於 「testnewkustocluster」 叢集中。

範例 2：檢查未使用中之 Kusto 資料庫名稱的可用性

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

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

上述命令會傳回 「mykustodatabase2」 的 Kusto 資料庫是否存在於 「testnewkustocluster」 叢集中。

參數

-ClusterName

Kusto 叢集的名稱。

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

-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

-Name

資源名稱。

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

-ResourceGroupName

資源群組的名稱。 名稱不區分大小寫。

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

-Type

資源類型，例如 Microsoft.Kusto/Clusters/databases。

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