Stream Analytics-taken bewaken en beheren met Azure PowerShell-cmdlets

Meer informatie over het bewaken en beheren van Stream Analytics-resources met Azure PowerShell-cmdlets en PowerShell-scripts waarmee eenvoudige Stream Analytics-taken worden uitgevoerd.

Notitie

In dit artikel wordt de Azure Az PowerShell-module gebruikt. Dit is de aanbevolen PowerShell-module voor interactie met Azure. Raadpleeg Azure PowerShell installeren om aan de slag te gaan met de Az PowerShell-module. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

Vereisten voor het uitvoeren van Azure PowerShell-cmdlets voor Stream Analytics

Azure PowerShell 0.9.8:

# Log in to your Azure account
Add-AzureAccount
# Select the Azure subscription you want to use to create the resource group if you have more han one subscription on your account.
Select-AzureSubscription -SubscriptionName <subscription name>
# If Stream Analytics has not been registered to the subscription, remove remark symbol below (#)to run the Register-AzureProvider cmdlet to register the provider namespace.
#Register-AzureProvider -Force -ProviderNamespace 'Microsoft.StreamAnalytics'
# Create an Azure resource group
New-AzureResourceGroup -Name <YOUR RESOURCE GROUP NAME> -Location <LOCATION>

Azure PowerShell 1.0:

# Log in to your Azure account
Connect-AzAccount
# Select the Azure subscription you want to use to create the resource group.
Get-AzSubscription -SubscriptionName "your sub" | Select-AzSubscription
# If Stream Analytics has not been registered to the subscription, remove remark symbol below (#)to run the Register-AzureProvider cmdlet to register the provider namespace.
#Register-AzResourceProvider -Force -ProviderNamespace 'Microsoft.StreamAnalytics'
# Create an Azure resource group
New-AzResourceGroup -Name <YOUR RESOURCE GROUP NAME> -Location <LOCATION>

Notitie

Stream Analytics-taken die programmatisch zijn gemaakt, hebben geen controle standaard ingeschakeld. U kunt bewaking handmatig inschakelen in Azure Portal door naar de pagina Monitor van de taak te gaan en op de knop Inschakelen te klikken of u kunt dit programmatisch doen door de stappen in Azure Stream Analytics - Stream Analytics-taken programmatisch te controleren.

Azure PowerShell-cmdlets voor Stream Analytics

De volgende Azure PowerShell-cmdlets kunnen worden gebruikt voor het bewaken en beheren van Azure Stream Analytics-taken. Houd er rekening mee dat Azure PowerShell verschillende versies heeft. In de voorbeelden die worden vermeld, is de eerste opdracht voor Azure PowerShell 0.9.8, de tweede opdracht is voor Azure PowerShell 1.0. De Azure PowerShell 1.0-opdrachten hebben altijd 'Az' in de opdracht.

Get-AzureStreamAnalyticsJob | Get-AzStreamAnalyticsJob

Geeft een lijst van alle Stream Analytics-taken die zijn gedefinieerd in het Azure-abonnement of de opgegeven resourcegroep, of haalt taakgegevens op over een specifieke taak binnen een resourcegroep.

Voorbeeld 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsJob

Met deze PowerShell-opdracht wordt informatie geretourneerd over alle Stream Analytics-taken in het Azure-abonnement.

Voorbeeld 2

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US 

Azure PowerShell 1.0:

Get-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US 

Deze PowerShell-opdracht retourneert informatie over alle Stream Analytics-taken in de resourcegroep StreamAnalytics-Default-Central-US.

Voorbeeld 3

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

Deze PowerShell-opdracht retourneert informatie over de Stream Analytics-taak StreamingJob in de resourcegroep StreamAnalytics-Default-Central-US.

Get-AzureStreamAnalyticsInput | Get-AzStreamAnalyticsInput

Geeft een lijst van alle invoergegevens die zijn gedefinieerd in een opgegeven Stream Analytics-taak of haalt informatie op over een specifieke invoer.

Voorbeeld 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

Deze PowerShell-opdracht retourneert informatie over alle invoer die is gedefinieerd in de taak StreamingJob.

Voorbeeld 2

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

Azure PowerShell 1.0:

Get-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

Met deze PowerShell-opdracht wordt informatie geretourneerd over de invoer met de naam EntryStream die is gedefinieerd in de taak StreamingJob.

Get-AzureStreamAnalyticsOutput | Get-AzStreamAnalyticsOutput

Geeft een lijst van alle uitvoer die zijn gedefinieerd in een opgegeven Stream Analytics-taak of haalt informatie op over een specifieke uitvoer.

Voorbeeld 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

Deze PowerShell-opdracht retourneert informatie over de uitvoer die is gedefinieerd in de taak StreamingJob.

Voorbeeld 2

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Azure PowerShell 1.0:

Get-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Met deze PowerShell-opdracht wordt informatie geretourneerd over de uitvoer met de naam Uitvoer die is gedefinieerd in de taak StreamingJob.

Get-AzureStreamAnalyticsQuota | Get-AzStreamAnalyticsQuota

Hiermee haalt u informatie op over het quotum van streaming-eenheden in een opgegeven regio.

Voorbeeld 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsQuota -Location "Central US" 

Azure PowerShell 1.0:

Get-AzStreamAnalyticsQuota -Location "Central US" 

Met deze PowerShell-opdracht wordt informatie geretourneerd over het quotum en het gebruik van streaming-eenheden in de regio VS - centraal.

Get-AzureStreamAnalyticsTransformation | Get-AzStreamAnalyticsTransformation

Hiermee haalt u informatie op over een specifieke transformatie die is gedefinieerd in een Stream Analytics-taak.

Voorbeeld 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name StreamingJob

Deze PowerShell-opdracht retourneert informatie over de transformatie met de naam StreamingJob in de taak StreamingJob.

New-AzureStreamAnalyticsInput | New-AzStreamAnalyticsInput

Hiermee maakt u een nieuwe invoer in een Stream Analytics-taak of werkt u een bestaande opgegeven invoer bij.

De naam van de invoer kan worden opgegeven in het JSON-bestand of op de opdrachtregel. Als beide zijn opgegeven, moet de naam op de opdrachtregel hetzelfde zijn als de naam in het bestand.

Als u een invoer opgeeft die al bestaat en de parameter -Force niet opgeeft, vraagt de cmdlet of de bestaande invoer al dan niet moet worden vervangen.

Als u de parameter -Force opgeeft en een bestaande invoernaam opgeeft, wordt de invoer vervangen zonder bevestiging.

Raadpleeg de sectie Invoer maken (Azure Stream Analytics) van de Rest API-referentiebibliotheek voor Stream Analytics voor gedetailleerde informatie over de JSON-bestandsstructuur en -inhoud.

Voorbeeld 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" 

Azure PowerShell 1.0:

New-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" 

Met deze PowerShell-opdracht maakt u een nieuwe invoer van het bestand Input.json. Als een bestaande invoer met de naam die is opgegeven in het invoerdefinitiebestand al is gedefinieerd, vraagt de cmdlet of deze al dan niet moet worden vervangen.

Voorbeeld 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream

Azure PowerShell 1.0:

New-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream

Met deze PowerShell-opdracht maakt u een nieuwe invoer in de taak met de naam EntryStream. Als er al een bestaande invoer met deze naam is gedefinieerd, vraagt de cmdlet of deze al dan niet moet worden vervangen.

Voorbeeld 3

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream -Force

Met deze PowerShell-opdracht wordt de definitie van de bestaande invoerbron met de naam EntryStream vervangen door de definitie uit het bestand.

New-AzureStreamAnalyticsJob | New-AzStreamAnalyticsJob

Hiermee maakt u een nieuwe Stream Analytics-taak in Microsoft Azure of werkt u de definitie van een bestaande opgegeven taak bij.

De naam van de taak kan worden opgegeven in het JSON-bestand of op de opdrachtregel. Als beide zijn opgegeven, moet de naam op de opdrachtregel hetzelfde zijn als de naam in het bestand.

Als u een taaknaam opgeeft die al bestaat en de parameter -Force niet opgeeft, vraagt de cmdlet of de bestaande taak al dan niet moet worden vervangen.

Als u de parameter -Force opgeeft en een bestaande taaknaam opgeeft, wordt de taakdefinitie vervangen zonder bevestiging.

Raadpleeg de sectie Stream Analytics-taak maken van de REST API-referentiebibliotheek voor Stream Analytics Management voor gedetailleerde informatie over de JSON-bestandsstructuur en -inhoud.

Voorbeeld 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json" 

Azure PowerShell 1.0:

New-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json" 

Met deze PowerShell-opdracht maakt u een nieuwe taak op basis van de definitie in JobDefinition.json. Als een bestaande taak met de naam die is opgegeven in het taakdefinitiebestand al is gedefinieerd, vraagt de cmdlet of deze al dan niet moet worden vervangen.

Voorbeeld 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json" -Name StreamingJob -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json" -Name StreamingJob -Force

Met deze PowerShell-opdracht wordt de taakdefinitie voor StreamingJob vervangen.

New-AzureStreamAnalyticsOutput | New-AzStreamAnalyticsOutput

Hiermee maakt u een nieuwe uitvoer in een Stream Analytics-taak of werkt u een bestaande uitvoer bij.

De naam van de uitvoer kan worden opgegeven in het .json-bestand of op de opdrachtregel. Als beide zijn opgegeven, moet de naam op de opdrachtregel hetzelfde zijn als de naam in het bestand.

Als u een uitvoer opgeeft die al bestaat en de parameter -Force niet opgeeft, vraagt de cmdlet of de bestaande uitvoer al dan niet moet worden vervangen.

Als u de parameter -Force opgeeft en een bestaande uitvoernaam opgeeft, wordt de uitvoer vervangen zonder bevestiging.

Raadpleeg de sectie Create Output (Azure Stream Analytics) van de Rest API-referentiebibliotheek voor Stream Analytics Management voor gedetailleerde informatie over de JSON-bestandsstructuur en -inhoud.

Voorbeeld 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output

Azure PowerShell 1.0:

New-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output

Met deze PowerShell-opdracht maakt u een nieuwe uitvoer met de naam 'output' in de taak StreamingJob. Als er al een bestaande uitvoer met deze naam is gedefinieerd, vraagt de cmdlet of deze al dan niet moet worden vervangen.

Voorbeeld 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output -Force

Deze PowerShell-opdracht vervangt de definitie voor 'uitvoer' in de taak StreamingJob.

New-AzureStreamAnalyticsTransformation | New-AzStreamAnalyticsTransformation

Hiermee maakt u een nieuwe transformatie binnen een Stream Analytics-taak of werkt u de bestaande transformatie bij.

De naam van de transformatie kan worden opgegeven in het JSON-bestand of op de opdrachtregel. Als beide zijn opgegeven, moet de naam op de opdrachtregel hetzelfde zijn als de naam in het bestand.

Als u een transformatie opgeeft die al bestaat en de parameter -Force niet opgeeft, vraagt de cmdlet of de bestaande transformatie al dan niet moet worden vervangen.

Als u de parameter -Force opgeeft en een bestaande transformatienaam opgeeft, wordt de transformatie vervangen zonder bevestiging.

Raadpleeg de sectie Create Transformation (Azure Stream Analytics) van de Rest API-naslagbibliotheek voor Stream Analytics Management voor gedetailleerde informatie over de JSON-bestandsstructuur en -inhoud.

Voorbeeld 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform

Azure PowerShell 1.0:

New-AzStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform

Met deze PowerShell-opdracht maakt u een nieuwe transformatie met de naam StreamingJobTransform in de taak StreamingJob. Als een bestaande transformatie al is gedefinieerd met deze naam, vraagt de cmdlet of deze al dan niet moet worden vervangen.

Voorbeeld 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform -Force

Deze PowerShell-opdracht vervangt de definitie van StreamingJobTransform in de taak StreamingJob.

Remove-AzureStreamAnalyticsInput | Remove-AzStreamAnalyticsInput

Met asynchroon verwijdert u een specifieke invoer uit een Stream Analytics-taak in Microsoft Azure.
Als u de parameter -Force opgeeft, wordt de invoer verwijderd zonder bevestiging.

Voorbeeld 1

Azure PowerShell 0.9.8:

Remove-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EventStream

Azure PowerShell 1.0:

Remove-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EventStream

Met deze PowerShell-opdracht verwijdert u de invoer EventStream in de taak StreamingJob.

Remove-AzureStreamAnalyticsJob | Remove-AzStreamAnalyticsJob

Hiermee verwijdert u asynchroon een specifieke Stream Analytics-taak in Microsoft Azure.
Als u de parameter -Force opgeeft, wordt de taak zonder bevestiging verwijderd.

Voorbeeld 1

Azure PowerShell 0.9.8:

Remove-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob 

Azure PowerShell 1.0:

Remove-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob 

Met deze PowerShell-opdracht wordt de taak StreamingJob verwijderd.

Remove-AzureStreamAnalyticsOutput | Remove-AzStreamAnalyticsOutput

Met asynchroon verwijdert u een specifieke uitvoer van een Stream Analytics-taak in Microsoft Azure.
Als u de parameter -Force opgeeft, wordt de uitvoer zonder bevestiging verwijderd.

Voorbeeld 1

Azure PowerShell 0.9.8:

Remove-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Azure PowerShell 1.0:

Remove-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Met deze PowerShell-opdracht wordt de uitvoeruitvoer in de taak StreamingJob verwijderd.

Start-AzureStreamAnalyticsJob | Start-AzStreamAnalyticsJob

Asynchroon implementeert en start een Stream Analytics-taak in Microsoft Azure.

Voorbeeld 1

Azure PowerShell 0.9.8:

Start-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob -OutputStartMode CustomTime -OutputStartTime 2012-12-12T12:12:12Z

Azure PowerShell 1.0:

Start-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob -OutputStartMode CustomTime -OutputStartTime 2012-12-12T12:12:12Z

Met deze PowerShell-opdracht start u de taak StreamingJob met een aangepaste begintijd voor uitvoer ingesteld op 12 december 2012, 12:12:12 UTC.

Stop-AzureStreamAnalyticsJob | Stop-AzStreamAnalyticsJob

Met asynchroon wordt een Stream Analytics-taak niet meer uitgevoerd in Microsoft Azure en worden resources die zijn gebruikt, ongedaan gemaakt. De taakdefinitie en metagegevens blijven beschikbaar in uw abonnement via zowel de Azure-portal als de beheer-API's, zodat de taak kan worden bewerkt en opnieuw kan worden gestart. Er worden geen kosten in rekening gebracht voor een taak met de status Gestopt.

Voorbeeld 1

Azure PowerShell 0.9.8:

Stop-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob 

Azure PowerShell 1.0:

Stop-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob 

Met deze PowerShell-opdracht wordt de taak StreamingJob gestopt.

Test-AzureStreamAnalyticsInput | Test-AzStreamAnalyticsInput

Test de mogelijkheid van Stream Analytics om verbinding te maken met een opgegeven invoer.

Voorbeeld 1

Azure PowerShell 0.9.8:

Test-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

Azure PowerShell 1.0:

Test-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

Met deze PowerShell-opdracht wordt de verbindingsstatus van de invoer EntryStream in StreamingJob getest.

Test-AzureStreamAnalyticsOutput | Test-AzStreamAnalyticsOutput

Test de mogelijkheid van Stream Analytics om verbinding te maken met een opgegeven uitvoer.

Voorbeeld 1

Azure PowerShell 0.9.8:

Test-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Azure PowerShell 1.0:

Test-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Met deze PowerShell-opdracht wordt de verbindingsstatus van de uitvoeruitvoer in StreamingJob getest.

Ondersteuning krijgen

Probeer onze Microsoft Q&A-vragenpagina voor Azure Stream Analytics voor meer hulp.

Volgende stappen