你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzSynapseKustoPoolDataConnection

模块:

Az.Synapse

更新数据连接。

语法

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>]

说明

更新数据连接。

示例

示例 1：更新现有的 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

上述命令为 kusto 池“testkustopool”中的数据库“testdatabase”更新名为“eventhubdc”的现有 EventHub 数据连接。

示例 2：更新现有的 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

上述命令为 kusto 池“testkustopool”中的数据库“testdatabase”更新名为“eventgriddc”的现有 EventGrid 数据连接。

示例 3：更新现有的 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

上述命令为 kusto 池“testkustopool”中的数据库“testdatabase”更新名为“iothubdc”的现有 IotHub 数据连接。

示例 4：通过标识更新现有 EventHub 数据连接

$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

上述命令为 kusto 池“testkustopool”中的数据库“testdatabase”更新名为“eventhubdc”的现有 EventHub 数据连接。

示例 5：通过标识更新现有 EventGrid 数据连接

$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

上述命令为 kusto 池“testkustopool”中的数据库“testdatabase”更新名为“eventgriddc”的现有 EventGrid 数据连接。

示例 6：通过标识更新现有 IotHub 数据连接

$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

上述命令为 kusto 池“testkustopool”中的数据库“testdatabase”更新名为“iothubdc”的现有 IotHub 数据连接。

参数

-AsJob

以作业身份运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BlobStorageEventType

要处理的 Blob 存储事件类型的名称。

类型:	BlobStorageEventType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Compression

事件中心消息压缩类型。

类型:	Compression
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConsumerGroup

事件/iot 中心使用者组。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DatabaseName

Kusto 池中数据库的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DataConnectionName

数据连接的名称。

类型:	String
别名:	Name
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DataFormat

消息的数据格式。 （可选）可将数据格式添加到每条消息。

类型:	EventGridDataFormat
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EventHubResourceId

用于创建数据连接/事件网格的事件中心的资源 ID 配置为发送事件。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-EventSystemProperty

事件/iot 中心的系统属性。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IgnoreFirstRecord

如果设置为 true，则表示引入应忽略每个文件的第一条记录。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

类型:	ISynapseIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-IotHubResourceId

要用于创建数据连接的 Iot 中心的资源 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Kind

数据连接的终结点类型

类型:	DataConnectionKind
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-KustoPoolName

Kusto 池的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Location

资源位置。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-MappingRuleName

用于引入数据的映射规则。 （可选）可以将映射信息添加到每个消息。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoWait

异步运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SharedAccessPolicyName

共享访问策略的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-StorageAccountResourceId

数据所在的存储帐户的资源 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SubscriptionId

目标订阅的 ID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-TableName

应引入数据的表。 （可选）可以将表信息添加到每个消息。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WorkspaceName

工作区的名称

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

ISynapseIdentity

输出

IDataConnection