Update-AzSynapseKustoPoolDataConnection
Aktualizuje datové připojení.
Syntaxe
Update-AzSynapseKustoPoolDataConnection
-DataConnectionName <String>
-DatabaseName <String>
-KustoPoolName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-WorkspaceName <String>
-Kind <DataConnectionKind>
-ConsumerGroup <String>
-Location <String>
-EventHubResourceId <String>
[-DataFormat <EventGridDataFormat>]
[-EventSystemProperty <String[]>]
[-MappingRuleName <String>]
[-TableName <String>]
[-Compression <Compression>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseKustoPoolDataConnection
-DataConnectionName <String>
-DatabaseName <String>
-KustoPoolName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-WorkspaceName <String>
-Kind <DataConnectionKind>
-ConsumerGroup <String>
-Location <String>
-EventHubResourceId <String>
[-DataFormat <EventGridDataFormat>]
[-MappingRuleName <String>]
[-TableName <String>]
-StorageAccountResourceId <String>
[-BlobStorageEventType <BlobStorageEventType>]
[-IgnoreFirstRecord]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseKustoPoolDataConnection
-DataConnectionName <String>
-DatabaseName <String>
-KustoPoolName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-WorkspaceName <String>
-Kind <DataConnectionKind>
-ConsumerGroup <String>
-Location <String>
[-DataFormat <EventGridDataFormat>]
[-EventSystemProperty <String[]>]
[-MappingRuleName <String>]
[-TableName <String>]
-IotHubResourceId <String>
-SharedAccessPolicyName <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseKustoPoolDataConnection
-InputObject <ISynapseIdentity>
-Kind <DataConnectionKind>
-ConsumerGroup <String>
-Location <String>
-EventHubResourceId <String>
[-DataFormat <EventGridDataFormat>]
[-EventSystemProperty <String[]>]
[-MappingRuleName <String>]
[-TableName <String>]
[-Compression <Compression>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseKustoPoolDataConnection
-InputObject <ISynapseIdentity>
-Kind <DataConnectionKind>
-ConsumerGroup <String>
-Location <String>
-EventHubResourceId <String>
[-DataFormat <EventGridDataFormat>]
[-MappingRuleName <String>]
[-TableName <String>]
-StorageAccountResourceId <String>
[-BlobStorageEventType <BlobStorageEventType>]
[-IgnoreFirstRecord]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseKustoPoolDataConnection
-InputObject <ISynapseIdentity>
-Kind <DataConnectionKind>
-ConsumerGroup <String>
-Location <String>
[-DataFormat <EventGridDataFormat>]
[-EventSystemProperty <String[]>]
[-MappingRuleName <String>]
[-TableName <String>]
-IotHubResourceId <String>
-SharedAccessPolicyName <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-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name eventhubdc -Location eastus2 -Kind EventHub -EventHubResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/testeventhubns/eventhubs/testeventhub" -DataFormat "JSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name
---- -------- ----
EventHub East US 2 testws/testkustopool/testdatabase/eventhubdc
Výše uvedený příkaz aktualizuje stávající datové připojení EventHub s názvem eventhubdc pro databázi testdatabase ve fondu Kusto testkustopool.
Příklad 2: Aktualizace existujícího datového připojení EventGrid
Update-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name eventgriddc -Location eastus2 -Kind EventGrid -EventHubResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/testeventhubns/eventhubs/testeventhub" -StorageAccountResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorage" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name
---- -------- ----
EventGrid East US 2 testws/testkustopool/testdatabase/eventgriddc
Výše uvedený příkaz aktualizuje existující datové připojení EventGrid s názvem "eventgriddc" pro databázi "testdatabase" ve fondu Kusto "testkustopool".
Příklad 3: Aktualizace existujícího datového připojení IotHub
Update-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name iothubdc -Location eastus2 -Kind IotHub -IotHubResourceId "/subscriptions/051ddeca-1ed6-4d8b-ba6f-1ff561e5f3b3/resourceGroups/ywtest/providers/Microsoft.Devices/IotHubs/ywtestiothub" -SharedAccessPolicyName registryRead -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name
---- -------- ----
IotHub East US 2 testws/testkustopool/testdatabase/iothubdc
Výše uvedený příkaz aktualizuje stávající datové připojení IotHub s názvem iothubdc pro databázi Testdatabase ve fondu Kusto testkustopool.
Příklad 4: Aktualizace existujícího datového připojení EventHubu prostřednictvím identity
$dataConnection = Get-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name eventhubdc
Update-AzSynapseKustoPoolDataConnection -InputObject $dataConnection -Location eastus2 -Kind EventHub -EventHubResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/testeventhubns/eventhubs/testeventhub" -DataFormat "JSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name
---- -------- ----
EventHub East US 2 testws/testkustopool/testdatabase/eventhubdc
Výše uvedený příkaz aktualizuje stávající datové připojení EventHub s názvem eventhubdc pro databázi testdatabase ve fondu Kusto testkustopool.
Příklad 5: Aktualizace existujícího datového připojení EventGrid prostřednictvím identity
$dataConnection = Get-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name eventgriddc
Update-AzSynapseKustoPoolDataConnection -InputObject $dataConnection -Location eastus2 -Kind EventGrid -EventHubResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/testeventhubns/eventhubs/testeventhub" -StorageAccountResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorage" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name
---- -------- ----
EventGrid East US 2 testws/testkustopool/testdatabase/eventgriddc
Výše uvedený příkaz aktualizuje existující datové připojení EventGrid s názvem "eventgriddc" pro databázi "testdatabase" ve fondu Kusto "testkustopool".
Příklad 6: Aktualizace existujícího datového připojení IotHubu prostřednictvím identity
$dataConnection = Get-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name iothubdc
Update-AzSynapseKustoPoolDataConnection -InputObject $dataConnection -Location eastus2 -Kind IotHub -IotHubResourceId "/subscriptions/051ddeca-1ed6-4d8b-ba6f-1ff561e5f3b3/resourceGroups/ywtest/providers/Microsoft.Devices/IotHubs/ywtestiothub" -SharedAccessPolicyName registryRead -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name
---- -------- ----
IotHub East US 2 testws/testkustopool/testdatabase/iothubdc
Výše uvedený příkaz aktualizuje stávající datové připojení IotHub s názvem iothubdc pro databázi Testdatabase ve fondu Kusto testkustopool.
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 |
-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 |
-DatabaseName
Název databáze ve fondu Kusto.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DataConnectionName
Název datového připojení.
Typ: | String |
Aliasy: | Name |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
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: | EventGridDataFormat |
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 |
-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: | ISynapseIdentity |
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: | DataConnectionKind |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-KustoPoolName
Název fondu Kusto.
Typ: | String |
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 |
-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 |
-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ů. Název nerozlišuje malá a velká písmena.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
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
ID cílového předplatného.
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 |
-WorkspaceName
Název pracovního prostoru
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Azure PowerShell