Update-AzKustoDataConnection

Reference

Modul:: Az.Kusto

Aktualizuje datové připojení.

Syntaxe

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

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

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

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

Update-AzKustoDataConnection
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -Location <String>
      [-TableName <String>]
      -EventHubResourceId <String>
      -ConsumerGroup <String>
      [-DataFormat <String>]
      [-EventSystemProperty <String[]>]
      [-MappingRuleName <String>]
      [-Compression <Compression>]
      [-ManagedIdentityResourceId <String>]
      [-DatabaseRouting <DatabaseRouting>]
      [-RetrievalStartDate <DateTime>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzKustoDataConnection
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -Location <String>
      [-TableName <String>]
      -EventHubResourceId <String>
      -ConsumerGroup <String>
      [-DataFormat <String>]
      [-MappingRuleName <String>]
      [-ManagedIdentityResourceId <String>]
      [-DatabaseRouting <DatabaseRouting>]
      -StorageAccountResourceId <String>
      [-BlobStorageEventType <BlobStorageEventType>]
      [-IgnoreFirstRecord]
      [-EventGridResourceId <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzKustoDataConnection
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -Location <String>
      [-TableName <String>]
      -ConsumerGroup <String>
      [-DataFormat <String>]
      [-EventSystemProperty <String[]>]
      [-MappingRuleName <String>]
      [-DatabaseRouting <DatabaseRouting>]
      [-RetrievalStartDate <DateTime>]
      -IotHubResourceId <String>
      -SharedAccessPolicyName <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzKustoDataConnection
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -Location <String>
      [-TableName <String>]
      [-MappingRuleName <String>]
      -ManagedIdentityResourceId <String>
      [-RetrievalStartDate <DateTime>]
      -CosmosDbAccountResourceId <String>
      -CosmosDbDatabase <String>
      -CosmosDbContainer <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Aktualizuje datové připojení.

Příklady

Příklad 1: Aktualizace existujícího datového připojení EventHub

Update-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 "MULTIJSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "NewEventsMapping"

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

Výše uvedený příkaz aktualizuje stávající datové připojení EventHub s názvem myeventhubdc pro databázi mykustodatabase v clusteru testnewkustocluster.

Příklad 2: Aktualizace existujícího datového připojení EventGrid

Update-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 "MULTIJSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "NewEventsMapping"

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

Výše uvedený příkaz aktualizuje stávající datové připojení EventGrid s názvem myeventgriddc pro databázi mykustodatabase v clusteru testnewkustocluster.

Příklad 3: Aktualizace existujícího datového připojení IotHub

Update-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 "MULTIJSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "NewEventsMapping"

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

Výše uvedený příkaz aktualizuje stávající datové připojení IotHub s názvem myiothubdc pro databázi mykustodatabase v clusteru testnewkustocluster.

Příklad 4: Aktualizace existujícího datového připojení EventHubu prostřednictvím identity

$dataConnection = Get-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventhubdc" 
Update-AzKustoDataConnection -InputObject $dataConnection -Location "East US" -Kind "EventHub" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -DataFormat "MULTIJSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "NewEventsMapping"

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

Výše uvedený příkaz aktualizuje stávající datové připojení EventHub s názvem myeventhubdc pro databázi mykustodatabase v clusteru testnewkustocluster.

Příklad 5: Aktualizace existujícího datového připojení EventGrid prostřednictvím identity

$dataConnection = Get-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventgriddc" 
Update-AzKustoDataConnection -InputObject $dataConnection -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 "MULTIJSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "NewEventsMapping"

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

Výše uvedený příkaz aktualizuje stávající datové připojení EventGrid s názvem myeventgriddc pro databázi mykustodatabase v clusteru testnewkustocluster.

Příklad 6: Aktualizace existujícího datového připojení IotHubu prostřednictvím identity

$dataConnection = Get-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myiothubdc" 
Update-AzKustoDataConnection -InputObject $dataConnection -Location "East US" -Kind "IotHub" -IotHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Devices/IotHubs/myiothub" -SharedAccessPolicyName "myiothubpolicy" -DataFormat "MULTIJSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "NewEventsMapping"

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

Výše uvedený příkaz aktualizuje stávající datové připojení IotHub s názvem myiothubdc pro databázi mykustodatabase v clusteru testnewkustocluster.

Parametry

-AsJob

Spuštění příkazu jako úlohy

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BlobStorageEventType

Název typu události úložiště objektů blob, který se má zpracovat.

Typ:	BlobStorageEventType
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ClusterName

Název clusteru Kusto.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Compression

Typ komprese centra událostí.

Typ:	Compression
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ConsumerGroup

Skupina příjemců event/iot Hub.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CosmosDbAccountResourceId

ID prostředku účtu cosmos DB použitého k vytvoření datového připojení.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CosmosDbContainer

Název existujícího kontejneru v databázi Cosmos DB.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CosmosDbDatabase

Název existující databáze v účtu cosmos DB.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DatabaseName

Název databáze v clusteru Kusto.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DatabaseRouting

Indikaci informací o směrování databáze z datového připojení jsou ve výchozím nastavení povoleny pouze informace o směrování databáze.

Typ:	DatabaseRouting
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataFormat

Formát dat zprávy. Volitelně je možné do každé zprávy přidat datový formát.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EventGridResourceId

ID prostředku event gridu, který se přihlašuje k odběru událostí účtu úložiště.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EventHubResourceId

ID prostředku centra událostí, které se má použít k vytvoření datového připojení nebo event gridu, je nakonfigurováno pro odesílání událostí.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EventSystemProperty

Systémové vlastnosti centra událostí nebo iot.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IgnoreFirstRecord

Pokud je nastavená hodnota true, znamená to, že příjem dat by měl ignorovat první záznam každého souboru.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Parametr Identity To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Typ:	IKustoIdentity
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-IotHubResourceId

ID prostředku centra IoT, které se má použít k vytvoření datového připojení.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Kind

Druh koncového bodu pro datové připojení

Typ:	Kind
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Location

Umístění prostředku

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagedIdentityResourceId

ID prostředku spravované identity (přiřazené systémem nebo uživatelem), které se má použít k ověření u externích prostředků.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MappingRuleName

Pravidlo mapování, které se má použít k ingestování dat. Volitelně lze do každé zprávy přidat informace o mapování.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název datového připojení.

Typ:	String
Aliasy:	DataConnectionName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoWait

Asynchronní spuštění příkazu

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků obsahující cluster Kusto.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RetrievalStartDate

Pokud je definováno, datové připojení načte existující události centra událostí vytvořené od data zahájení načtení. Na základě doby uchovávání může načítat pouze události uchováné centrem událostí.

Typ:	DateTime
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SharedAccessPolicyName

Název zásady přístupu ke sdílené složce.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StorageAccountResourceId

ID prostředku účtu úložiště, ve kterém se data nacházejí.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubscriptionId

Získá přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

Typ:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TableName

Tabulka, ve které se mají data ingestovat. Volitelně je možné do každé zprávy přidat informace o tabulce.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

IKustoIdentity

Výstupy

IDataConnection

Sdílet prostřednictvím