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
Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. 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
- Maak een Azure-resourcegroep in uw abonnement. Hier volgt een voorbeeld van een Azure PowerShell-script. Zie Azure PowerShell installeren en configureren voor informatie over Azure PowerShell.
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
Voor Stream Analytics-taken die via een programma zijn gemaakt, is bewaking niet 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 weer 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
Met deze PowerShell-opdracht wordt informatie geretourneerd 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
Met deze PowerShell-opdracht wordt informatie geretourneerd over de Stream Analytics-taak StreamingJob in de resourcegroep StreamAnalytics-Default-Central-US.
Get-AzureStreamAnalyticsInput | Get-AzStreamAnalyticsInput
Geeft een lijst weer van alle invoer die zijn gedefinieerd in een opgegeven Stream Analytics-taak of haalt informatie over een specifieke invoer op.
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
Met deze PowerShell-opdracht wordt informatie geretourneerd 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 weer 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
Haalt 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
Met deze PowerShell-opdracht wordt informatie geretourneerd 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 zonder bevestiging vervangen.
Raadpleeg de sectie Create Input (Azure Stream Analytics) van de Rest API-referentiebibliotheek van 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 zonder bevestiging vervangen.
Raadpleeg de sectie Stream Analytics-taak maken 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-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 zonder bevestiging vervangen.
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 'uitvoer' in de taak StreamingJob. Als er al een bestaande uitvoer met deze naam is gedefinieerd, wordt door de cmdlet gevraagd 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
Met deze PowerShell-opdracht wordt de definitie voor 'uitvoer' in de taak StreamingJob vervangen.
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 zonder bevestiging vervangen.
Raadpleeg de sectie Create Transformation (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-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, wordt door de cmdlet gevraagd 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
Hiermee verwijdert u asynchroon een specifieke invoer uit een Stream Analytics-taak in Microsoft Azure.
Als u de parameter -Force opgeeft, wordt de invoer zonder bevestiging verwijderd.
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 wordt de invoer EventStream in de taak StreamingJob verwijderd.
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
Hiermee verwijdert u asynchroon 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 in de gestopte status.
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.