Invoke-AzKustoDataConnectionValidation
Verifica se os parâmetros de conexão de dados são válidos.
Syntax
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>] Description
Verifica se os parâmetros de conexão de dados são válidos.
Exemplos
Exemplo 1: Validar parâmetros de conexão de dados do 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 "JSON" -ConsumerGroup 'Default' -Compression "None" -TableName "Events" -MappingRuleName "NewEventsMapping"
ErrorMessage
------------
event hub resource id and consumer group tuple provided are already usedO comando acima valida a conexão de dados do EventHub chamada "myeventhubdc" para o banco de dados "mykustodatabase" no cluster "testnewkustocluster".
Exemplo 2: Validar parâmetros de conexão de dados 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 "JSON" -ConsumerGroup 'Default' -TableName "Events" -MappingRuleName "NewEventsMapping"
ErrorMessage
------------
event hub resource id and consumer group tuple provided are already usedO comando acima valida a conexão de dados EventGrid chamada "myeventgriddc" para o banco de dados "mykustodatabase" no cluster "testnewkustocluster".
Exemplo 3: Validar parâmetros de conexão de dados do 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 "JSON" -ConsumerGroup 'Default' -TableName "Events" -MappingRuleName "NewEventsMapping"
ErrorMessage
------------
event hub resource id and consumer group tuple provided are already usedO comando acima valida a conexão de dados do IotHub chamada "myiothubdc" para o banco de dados "mykustodatabase" no cluster "testnewkustocluster".
Exemplo 4: Validar parâmetros de conexão de dados do EventHub por meio de identidade
$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 "JSON" -ConsumerGroup 'Default' -Compression "None" -TableName "Events" -MappingRuleName "NewEventsMapping"
ErrorMessage
------------
event hub resource id and consumer group tuple provided are already usedO comando acima valida a conexão de dados do EventHub chamada "myeventhubdc" para o banco de dados "mykustodatabase" no cluster "testnewkustocluster".
Exemplo 5: Validar parâmetros de conexão de dados do EventGrid por meio de identidade
$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 "JSON" -ConsumerGroup 'Default' -TableName "Events" -MappingRuleName "NewEventsMapping"
ErrorMessage
------------
event hub resource id and consumer group tuple provided are already usedO comando acima valida a conexão de dados EventGrid chamada "myeventgriddc" para o banco de dados "mykustodatabase" no cluster "testnewkustocluster".
Exemplo 6: Validar parâmetros de conexão de dados do IotHub via identidade
$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 "JSON" -ConsumerGroup 'Default' -TableName "Events" -MappingRuleName "NewEventsMapping"
ErrorMessage
------------
event hub resource id and consumer group tuple provided are already usedO comando acima valida a conexão de dados do IotHub chamada "myiothubdc" para o banco de dados "mykustodatabase" no cluster "testnewkustocluster".
Parâmetros
-BlobStorageEventType
O nome do tipo de evento de armazenamento de blob a ser processado.
| Tipo: | BlobStorageEventType |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClusterName
O nome do cluster Kusto.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Compression
O tipo de compactação de mensagens do hub de eventos.
| Tipo: | Compression |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsumerGroup
O grupo de consumidores do hub de eventos/iot.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseName
O nome do banco de dados no cluster Kusto.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseRouting
Indicação para informações de roteamento de banco de dados da conexão de dados, por padrão, apenas informações de roteamento de banco de dados são permitidas.
| Tipo: | DatabaseRouting |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataConnectionName
O nome da conexão de dados.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataFormat
O formato de dados da mensagem. Opcionalmente, o formato de dados pode ser adicionado a cada mensagem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventGridResourceId
A ID do recurso da grade de eventos inscrita nos eventos da conta de armazenamento.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventHubResourceId
O ID de recurso do hub de eventos a ser usado para criar uma conexão de dados / grade de eventos é configurado para enviar eventos.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventSystemProperty
Propriedades do sistema do hub de eventos/iot.
| Tipo: | String[] |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IgnoreFirstRecord
Se definido como true, indica que a ingestão deve ignorar o primeiro registro de cada arquivo.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.
| Tipo: | IKustoIdentity |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IotHubResourceId
O ID do recurso do hub Iot a ser usado para criar uma conexão de dados.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Kind
Tipo de ponto de extremidade para a conexão de dados
| Tipo: | Kind |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Localização do recurso.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagedIdentityResourceId
O ID de recurso de uma identidade gerenciada (sistema ou usuário atribuído) a ser usado para autenticar com recursos externos.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MappingRuleName
A regra de mapeamento a ser usada para ingerir os dados. Opcionalmente, as informações de mapeamento podem ser adicionadas a cada mensagem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
O nome do grupo de recursos que contém o cluster Kusto.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RetrievalStartDate
Quando definida, a conexão de dados recupera eventos existentes do hub de eventos criados desde a data de início da recuperação. Ele só pode recuperar eventos retidos pelo hub de eventos, com base em seu período de retenção.
| Tipo: | DateTime |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharedAccessPolicyName
O nome da política de acesso de compartilhamento.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountResourceId
O ID do recurso da conta de armazenamento onde os dados residem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | (Get-AzContext).Subscription.Id |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableName
A tabela onde os dados devem ser ingeridos. Opcionalmente, as informações da tabela podem ser adicionadas a cada mensagem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Saídas
Azure PowerShell
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários