Delen via


Update-AzKustoDataConnection

Hiermee werkt u een gegevensverbinding bij.

Syntaxis

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

Hiermee werkt u een gegevensverbinding bij.

Voorbeelden

Voorbeeld 1: Een bestaande EventHub-gegevensverbinding bijwerken

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

Met de bovenstaande opdracht wordt de bestaande EventHub-gegevensverbinding met de naam 'myeventhubdc' bijgewerkt voor de database 'mykustodatabase' in het cluster 'testnewkustocluster'.

Voorbeeld 2: Een bestaande EventGrid-gegevensverbinding bijwerken

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

Met de bovenstaande opdracht wordt de bestaande EventGrid-gegevensverbinding met de naam 'myeventgriddc' bijgewerkt voor de database 'mykustodatabase' in het cluster 'testnewkustocluster'.

Voorbeeld 3: Een bestaande IotHub-gegevensverbinding bijwerken

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

Met de bovenstaande opdracht wordt de bestaande IotHub-gegevensverbinding met de naam 'myiothubdc' bijgewerkt voor de database 'mykustodatabase' in het cluster 'testnewkustocluster'.

Voorbeeld 4: Een bestaande EventHub-gegevensverbinding bijwerken via identiteit

$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

Met de bovenstaande opdracht wordt de bestaande EventHub-gegevensverbinding met de naam 'myeventhubdc' bijgewerkt voor de database 'mykustodatabase' in het cluster 'testnewkustocluster'.

Voorbeeld 5: Een bestaande EventGrid-gegevensverbinding bijwerken via identiteit

$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

Met de bovenstaande opdracht wordt de bestaande EventGrid-gegevensverbinding met de naam 'myeventgriddc' bijgewerkt voor de database 'mykustodatabase' in het cluster 'testnewkustocluster'.

Voorbeeld 6: Een bestaande IotHub-gegevensverbinding bijwerken via identiteit

$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

Met de bovenstaande opdracht wordt de bestaande IotHub-gegevensverbinding met de naam 'myiothubdc' bijgewerkt voor de database 'mykustodatabase' in het cluster 'testnewkustocluster'.

Parameters

-AsJob

De opdracht uitvoeren als een taak

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BlobStorageEventType

De naam van het type blob storage-gebeurtenis dat moet worden verwerkt.

Type:BlobStorageEventType
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ClusterName

De naam van het Kusto-cluster.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Compression

Het compressietype event hub-berichten.

Type:Compression
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConsumerGroup

De event/iot hub-consumentengroep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CosmosDbAccountResourceId

De resource-id van het Cosmos DB-account dat wordt gebruikt om de gegevensverbinding te maken.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CosmosDbContainer

De naam van een bestaande container in de Cosmos DB-database.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CosmosDbDatabase

De naam van een bestaande database in het Cosmos DB-account.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DatabaseName

De naam van de database in het Kusto-cluster.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DatabaseRouting

Indicatie voor gegevens over databaseroutering van de gegevensverbinding, standaard is alleen informatie over databaseroutering toegestaan.

Type:DatabaseRouting
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DataFormat

De gegevensindeling van het bericht. Desgewenst kan de gegevensindeling aan elk bericht worden toegevoegd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EventGridResourceId

De resource-id van het gebeurtenisraster dat is geabonneerd op de gebeurtenissen van het opslagaccount.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EventHubResourceId

De resource-id van de Event Hub die moet worden gebruikt om een gegevensverbinding/event grid te maken, is geconfigureerd voor het verzenden van gebeurtenissen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EventSystemProperty

Systeemeigenschappen van de event/iot-hub.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IgnoreFirstRecord

Als deze optie is ingesteld op true, geeft u aan dat opname de eerste record van elk bestand moet negeren.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Identity Parameter To construct, zie DE SECTIE NOTES voor INPUTOBJECT-eigenschappen en maak een hash-tabel.

Type:IKustoIdentity
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IotHubResourceId

De resource-id van de IoT-hub die moet worden gebruikt om een gegevensverbinding te maken.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Kind

Soort eindpunt voor de gegevensverbinding

Type:Kind
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Resourcelocatie.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ManagedIdentityResourceId

De resource-id van een beheerde identiteit (door het systeem of de gebruiker toegewezen) die moet worden gebruikt voor verificatie met externe resources.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MappingRuleName

De toewijzingsregel die moet worden gebruikt om de gegevens op te nemen. Desgewenst kunnen de toewijzingsgegevens aan elk bericht worden toegevoegd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

De naam van de gegevensverbinding.

Type:String
Aliassen:DataConnectionName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoWait

De opdracht asynchroon uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep die het Kusto-cluster bevat.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RetrievalStartDate

Wanneer deze is gedefinieerd, haalt de gegevensverbinding bestaande Event Hub-gebeurtenissen op die zijn gemaakt sinds de begindatum van het ophalen. Het kan alleen gebeurtenissen ophalen die worden bewaard door de Event Hub, op basis van de retentieperiode.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SharedAccessPolicyName

De naam van het toegangsbeleid voor delen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StorageAccountResourceId

De resource-id van het opslagaccount waarin de gegevens zich bevinden.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubscriptionId

Hiermee haalt u abonnementsreferenties op die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TableName

De tabel waarin de gegevens moeten worden opgenomen. Desgewenst kunnen de tabelgegevens aan elk bericht worden toegevoegd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

IKustoIdentity

Uitvoerwaarden

IDataConnection