Update-AzKustoDataConnection

Referencia

Módulo:: Az.Kusto

Actualiza una conexión de datos.

Sintaxis

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

Actualiza una conexión de datos.

Ejemplos

Ejemplo 1: Actualización de una conexión de datos de EventHub existente

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

El comando anterior actualiza la conexión de datos de EventHub existente denominada "myeventhubdc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".

Ejemplo 2: Actualización de una conexión de datos de EventGrid existente

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

El comando anterior actualiza la conexión de datos de EventGrid existente denominada "myeventgriddc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".

Ejemplo 3: Actualización de una conexión de datos de IotHub existente

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

El comando anterior actualiza la conexión de datos de IotHub existente denominada "myiothubdc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".

Ejemplo 4: Actualización de una conexión de datos de EventHub existente a través de la identidad

$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

El comando anterior actualiza la conexión de datos de EventHub existente denominada "myeventhubdc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".

Ejemplo 5: Actualización de una conexión de datos de EventGrid existente a través de la identidad

$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

El comando anterior actualiza la conexión de datos de EventGrid existente denominada "myeventgriddc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".

Ejemplo 6: Actualización de una conexión de datos de IotHub existente a través de la identidad

$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

El comando anterior actualiza la conexión de datos de IotHub existente denominada "myiothubdc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".

Parámetros

-AsJob

Ejecución del comando como trabajo

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BlobStorageEventType

Nombre del tipo de evento de Blob Storage que se va a procesar.

Tipo:	BlobStorageEventType
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClusterName

Nombre del clúster de Kusto.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Compression

Tipo de compresión de mensajes del centro de eventos.

Tipo:	Compression
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ConsumerGroup

El grupo de consumidores de event/iot hub.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CosmosDbAccountResourceId

Identificador de recurso de la cuenta de Cosmos DB que se usa para crear la conexión de datos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CosmosDbContainer

Nombre de un contenedor existente en la base de datos de Cosmos DB.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CosmosDbDatabase

Nombre de una base de datos existente en la cuenta de Cosmos DB.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DatabaseName

Nombre de la base de datos en el clúster de Kusto.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DatabaseRouting

Indicación de la información de enrutamiento de base de datos de la conexión de datos, de forma predeterminada solo se permite la información de enrutamiento de base de datos.

Tipo:	DatabaseRouting
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DataFormat

Formato de datos del mensaje. Opcionalmente, el formato de datos se puede agregar a cada mensaje.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EventGridResourceId

Identificador de recurso de la cuadrícula de eventos que se suscribe a los eventos de la cuenta de almacenamiento.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EventHubResourceId

El identificador de recurso del centro de eventos que se va a usar para crear una conexión de datos o Event Grid está configurado para enviar eventos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EventSystemProperty

Propiedades del sistema del centro de eventos/iot.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IgnoreFirstRecord

Si se establece en true, indica que la ingesta debe omitir el primer registro de cada archivo.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Parámetro de identidad Para construir, vea la sección NOTES para las propiedades INPUTOBJECT y crear una tabla hash.

Tipo:	IKustoIdentity
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-IotHubResourceId

Identificador de recurso del centro de IoT que se va a usar para crear una conexión de datos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Kind

Tipo de punto de conexión para la conexión de datos

Tipo:	Kind
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Location

Ubicación del recurso.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ManagedIdentityResourceId

Identificador de recurso de una identidad administrada (sistema o usuario asignado) que se usará para autenticarse con recursos externos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MappingRuleName

Regla de asignación que se va a usar para ingerir los datos. Opcionalmente, la información de asignación se puede agregar a cada mensaje.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

Nombre de la conexión de datos.

Tipo:	String
Alias:	DataConnectionName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Nombre del grupo de recursos que contiene el clúster de Kusto.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RetrievalStartDate

Cuando se define, la conexión de datos recupera los eventos existentes del centro de eventos creados desde la fecha de inicio de recuperación. Solo puede recuperar eventos retenidos por el centro de eventos, en función de su período de retención.

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SharedAccessPolicyName

Nombre de la directiva de acceso a recursos compartidos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageAccountResourceId

Identificador de recurso de la cuenta de almacenamiento donde residen los datos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SubscriptionId

Obtiene las credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.

Tipo:	String
Posición:	Named
Valor predeterminado:	(Get-AzContext).Subscription.Id
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TableName

Tabla donde se deben ingerir los datos. Opcionalmente, la información de la tabla se puede agregar a cada mensaje.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

IKustoIdentity

Salidas

IDataConnection

Compartir a través de