New-AzKustoDataConnection

模組:

Az.Kusto

建立或更新數據連線。

Syntax

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   -ConsumerGroup <String>
   -EventHubResourceId <String>
   -Kind <Kind>
   -Location <String>
   [-SubscriptionId <String>]
   [-Compression <Compression>]
   [-DatabaseRouting <DatabaseRouting>]
   [-DataFormat <String>]
   [-EventSystemProperty <String[]>]
   [-ManagedIdentityResourceId <String>]
   [-MappingRuleName <String>]
   [-RetrievalStartDate <DateTime>]
   [-TableName <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   -CosmosDbAccountResourceId <String>
   -CosmosDbContainer <String>
   -CosmosDbDatabase <String>
   -Kind <Kind>
   -Location <String>
   -ManagedIdentityResourceId <String>
   -TableName <String>
   [-SubscriptionId <String>]
   [-MappingRuleName <String>]
   [-RetrievalStartDate <DateTime>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   -ConsumerGroup <String>
   -EventHubResourceId <String>
   -Kind <Kind>
   -Location <String>
   -StorageAccountResourceId <String>
   [-SubscriptionId <String>]
   [-BlobStorageEventType <BlobStorageEventType>]
   [-DatabaseRouting <DatabaseRouting>]
   [-DataFormat <String>]
   [-EventGridResourceId <String>]
   [-IgnoreFirstRecord]
   [-ManagedIdentityResourceId <String>]
   [-MappingRuleName <String>]
   [-TableName <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   -ConsumerGroup <String>
   -IotHubResourceId <String>
   -Kind <Kind>
   -Location <String>
   -SharedAccessPolicyName <String>
   [-SubscriptionId <String>]
   [-DatabaseRouting <DatabaseRouting>]
   [-DataFormat <String>]
   [-EventSystemProperty <String[]>]
   [-MappingRuleName <String>]
   [-RetrievalStartDate <DateTime>]
   [-TableName <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

建立或更新數據連線。

範例

範例 1：建立新的 EventHub 數據連線

New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventhubdc" -Location "East US" -Kind "EventHub" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -DataFormat "JSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "EventsMapping"

Kind     Location Name                                             Type
----     -------- ----                                             ----
EventHub East US  testnewkustocluster/mykustodatabase/myeventhubdc Microsoft.Kusto/Clusters/Databases/DataConnections

上述命令會在叢集 「testnewkustocluster」 中，為資料庫 「mykustodatabase」 建立名為 「myeventhubdc」 的新 EventHub 數據連線。

範例 2：建立新的 EventGrid 數據連線

New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventgriddc" -Location "East US" -Kind "EventGrid" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -StorageAccountResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Storage/storageAccounts/mystorage" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"

Kind      Location Name                                              Type
----      -------- ----                                              ----
EventGrid East US  testnewkustocluster/mykustodatabase/myeventgriddc Microsoft.Kusto/Clusters/Databases/DataConnections

上述命令會在叢集 「testnewkustocluster」 中，為資料庫 「mykustodatabase」 建立名為 「myeventgriddc」 的新 EventGrid 數據連線。

範例 3：建立新的 IotHub 數據連線

New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myiothubdc" -Location "East US" -Kind "IotHub" -IotHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Devices/IotHubs/myiothub" -SharedAccessPolicyName "myiothubpolicy" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"

Kind      Location Name                                        Type
----      -------- ----                                        ----
IotHub East US  testnewkustocluster/mykustodatabase/myiothubdc Microsoft.Kusto/Clusters/Databases/DataConnections

上述命令會在叢集 「testnewkustocluster」 中，為資料庫 「mykustodatabase」 建立名為 「myiothubdc」 的新 IotHub 數據連線。

參數

-AsJob

以作業身分執行命令

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

-BlobStorageEventType

要處理的 Blob 記憶體事件類型名稱。

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

-ClusterName

Kusto 叢集的名稱。

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

-Compression

事件中樞訊息壓縮類型。

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

-ConsumerGroup

事件/iot 中樞取用者群組。

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

-CosmosDbAccountResourceId

用來建立數據連線的 Cosmos DB 帳戶資源識別碼。

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

-CosmosDbContainer

Cosmos DB 資料庫中現有容器的名稱。

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

-CosmosDbDatabase

Cosmos DB 帳戶中現有資料庫的名稱。

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

-DatabaseName

Kusto 叢集中的資料庫名稱。

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

-DatabaseRouting

數據連線的資料庫路由資訊指示，預設只允許資料庫路由資訊。

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

-DataFormat

訊息的數據格式。 您可以選擇性地將資料格式新增至每個訊息。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-EventGridResourceId

訂閱記憶體帳戶事件的事件方格資源標識碼。

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

-EventHubResourceId

要用來建立數據連線/事件方格的事件中樞資源標識符已設定為傳送事件。

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

-EventSystemProperty

事件/iot 中樞的系統屬性。

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

-IgnoreFirstRecord

如果設定為 true，表示擷取應該忽略每個檔案的第一筆記錄。

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

-IotHubResourceId

要用來建立數據連線之IoT中樞的資源標識碼。

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

-Kind

數據連線的端點種類

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

-Location

資源位置。

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

-ManagedIdentityResourceId

要用來向外部資源進行驗證的受控識別資源標識碼（系統或使用者指派）。

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

-MappingRuleName

要用來內嵌數據的對應規則。 您可以選擇性地將對應資訊新增至每個訊息。

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

-Name

數據連接的名稱。

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

-NoWait

以異步方式執行命令

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

-ResourceGroupName

包含 Kusto 叢集的資源群組名稱。

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

-RetrievalStartDate

定義時，數據聯機會擷取自擷取開始日期之後建立的現有事件中樞事件。 它只能根據事件中樞的保留期間擷取事件。

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

-SharedAccessPolicyName

共用存取原則的名稱。

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

-StorageAccountResourceId

數據所在記憶體帳戶的資源標識碼。

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

-SubscriptionId

取得可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

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

-TableName

應該內嵌數據的數據表。 您可以選擇性地將資料表資訊新增至每個訊息。

Type:	String
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

輸出

IDataConnection