Invoke-AzKustoDataConnectionValidation

Модуль:

Az.Kusto

Проверяет, допустимы ли параметры подключения к данным.

Синтаксис

Invoke-AzKustoDataConnectionValidation
      -ClusterName <String>
      -DatabaseName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      -EventHubResourceId <String>
      [-DataFormat <String>]
      [-EventSystemProperty <String[]>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-Compression <Compression>]
      [-ManagedIdentityResourceId <String>]
      [-DatabaseRouting <DatabaseRouting>]
      [-RetrievalStartDate <DateTime>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -ClusterName <String>
      -DatabaseName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      -EventHubResourceId <String>
      [-DataFormat <String>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-ManagedIdentityResourceId <String>]
      [-DatabaseRouting <DatabaseRouting>]
      -StorageAccountResourceId <String>
      [-EventGridResourceId <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -ClusterName <String>
      -DatabaseName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      [-DataFormat <String>]
      [-EventSystemProperty <String[]>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-DatabaseRouting <DatabaseRouting>]
      [-RetrievalStartDate <DateTime>]
      -IotHubResourceId <String>
      -SharedAccessPolicyName <String>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      -EventHubResourceId <String>
      [-DataFormat <String>]
      [-EventSystemProperty <String[]>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-Compression <Compression>]
      [-ManagedIdentityResourceId <String>]
      [-DatabaseRouting <DatabaseRouting>]
      [-RetrievalStartDate <DateTime>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      -EventHubResourceId <String>
      [-DataFormat <String>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-ManagedIdentityResourceId <String>]
      [-DatabaseRouting <DatabaseRouting>]
      -StorageAccountResourceId <String>
      [-EventGridResourceId <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -InputObject <IKustoIdentity>
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      [-DataFormat <String>]
      [-EventSystemProperty <String[]>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-DatabaseRouting <DatabaseRouting>]
      [-RetrievalStartDate <DateTime>]
      -IotHubResourceId <String>
      -SharedAccessPolicyName <String>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      [-DataFormat <String>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-BlobStorageEventType <BlobStorageEventType>]
      [-IgnoreFirstRecord]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzKustoDataConnectionValidation
      -Kind <Kind>
      -DataConnectionName <String>
      -ConsumerGroup <String>
      -Location <String>
      [-DataFormat <String>]
      [-MappingRuleName <String>]
      [-TableName <String>]
      [-BlobStorageEventType <BlobStorageEventType>]
      [-IgnoreFirstRecord]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Проверяет, допустимы ли параметры подключения к данным.

Примеры

Пример 1. Проверка параметров подключения к данным EventHub

Invoke-AzKustoDataConnectionValidation -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"

ErrorMessage
------------
event hub resource id and consumer group tuple provided are already used

Приведенная выше команда проверяет подключение к данным EventHub с именем myeventhubdc для базы данных mykustodatabase в кластере testnewkustocluster.

Пример 2. Проверка параметров подключения к данным EventGrid

Invoke-AzKustoDataConnectionValidation -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"

ErrorMessage
------------
event hub resource id and consumer group tuple provided are already used

Приведенная выше команда проверяет подключение к данным EventGrid с именем myeventgriddc для базы данных mykustodatabase в кластере testnewkustocluster.

Пример 3. Проверка параметров подключения к данным IotHub

Invoke-AzKustoDataConnectionValidation -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"

ErrorMessage
------------
event hub resource id and consumer group tuple provided are already used

Приведенная выше команда проверяет подключение данных IotHub с именем myiothubdc для базы данных mykustodatabase в кластере testnewkustocluster.

Пример 4. Проверка параметров подключения данных EventHub с помощью удостоверения

$database = Get-AzKustoDatabase -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" 
Invoke-AzKustoDataConnectionValidation -InputObject $database -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"

ErrorMessage
------------
event hub resource id and consumer group tuple provided are already used

Приведенная выше команда проверяет подключение к данным EventHub с именем myeventhubdc для базы данных mykustodatabase в кластере testnewkustocluster.

Пример 5. Проверка параметров подключения к данным EventGrid с помощью удостоверения

$database = Get-AzKustoDatabase -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase"
Invoke-AzKustoDataConnectionValidation -InputObject $database -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"

ErrorMessage
------------
event hub resource id and consumer group tuple provided are already used

Приведенная выше команда проверяет подключение к данным EventGrid с именем myeventgriddc для базы данных mykustodatabase в кластере testnewkustocluster.

Пример 6. Проверка параметров подключения к данным IotHub с помощью удостоверения

$database = Get-AzKustoDatabase -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" 
Invoke-AzKustoDataConnectionValidation -InputObject $database -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"

ErrorMessage
------------
event hub resource id and consumer group tuple provided are already used

Приведенная выше команда проверяет подключение данных IotHub с именем myiothubdc для базы данных mykustodatabase в кластере testnewkustocluster.

Параметры

-BlobStorageEventType

Имя типа события хранилища BLOB-объектов для обработки.

Тип:	BlobStorageEventType
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ClusterName

Имя кластера Kusto.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Compression

Тип сжатия сообщений концентратора событий.

Тип:	Compression
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ConsumerGroup

Группа потребителей центра событий и центра iot.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DatabaseName

Имя базы данных в кластере Kusto.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DatabaseRouting

Указание сведений о маршрутизации баз данных из подключения к данным по умолчанию допускается только для сведений о маршрутизации баз данных.

Тип:	DatabaseRouting
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DataConnectionName

Имя подключения к данным.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DataFormat

Формат данных сообщения. При необходимости формат данных можно добавить в каждое сообщение.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EventGridResourceId

Идентификатор ресурса сетки событий, которая подписана на события учетной записи хранения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EventHubResourceId

Идентификатор ресурса концентратора событий, используемый для создания подключения к данным или сетки событий, настроен для отправки событий.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EventSystemProperty

Системные свойства концентратора событий или центра iot.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IgnoreFirstRecord

Если задано значение true, указывает, что прием должен игнорировать первую запись каждого файла.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Параметр удостоверений Для создания см. раздел NOTES для свойств INPUTOBJECT и создание хэш-таблицы.

Тип:	IKustoIdentity
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-IotHubResourceId

Идентификатор ресурса центра Iot, который будет использоваться для создания подключения к данным.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Kind

Тип конечной точки для подключения к данным

Тип:	Kind
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Location

Расположение ресурса.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ManagedIdentityResourceId

Идентификатор ресурса управляемого удостоверения (назначаемого системой или пользователем) для проверки подлинности с внешними ресурсами.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MappingRuleName

Правило сопоставления, используемое для приема данных. При необходимости сведения о сопоставлении можно добавить в каждое сообщение.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceGroupName

Имя группы ресурсов, содержащей кластер Kusto.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RetrievalStartDate

При определении подключение к данным извлекает существующие события концентратора событий, созданные с момента начала извлечения. Он может получать только события, сохраненные концентратором событий, на основе периода хранения.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SharedAccessPolicyName

Имя политики доступа к общей папке.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-StorageAccountResourceId

Идентификатор ресурса учетной записи хранения, в которой находятся данные.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SubscriptionId

Получает учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.

Тип:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TableName

Таблица, в которой должны приниматься данные. При необходимости сведения о таблице можно добавить в каждое сообщение.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

IKustoIdentity

Выходные данные

IDataConnectionValidationResult