透過 Azure PowerShell Cmdlet 監視和管理串流分析工作
了解如何透過執行基本串流分析工作的 Azure PowerShell Cmdlet 及 PowerShell Cmdlet 來監視及管理串流分析的資源。
注意
建議您使用 Azure Az PowerShell 模組來與 Azure 互動。 若要開始使用，請參閱 安裝 Azure PowerShell。 若要了解如何移轉至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。
執行 Azure PowerShell Cmdlet 進行串流分析的必要條件
- 在您的訂用帳戶中建立「Azure 資源群組」。 下列是 PowerShell 指令碼範例。 如需 Azure PowerShell 資訊，請參閱 安裝並設定 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>
注意
以程式控制方式建立的串流分析工作預設不會啟用監視功能。 您可以在 Azure 入口網站中巡覽至工作的 [監視] 頁面，並按一下 [啟用] 按鈕，以手動啟用監視，也可以依照 Azure 串流分析 - 以程式設計方式監視串流分析工作中的步驟，以程式設計方式啟用監視。
用於串流分析的 Azure PowerShell Cmdlet
下表列出可用來監視和管理 Azure 串流分析工作的 Azure PowerShell Cmdlet。 請注意，Azure PowerShell 有不同的版本。 下列範例中所列出的第一個命令是針對 Azure PowerShell 0.9.8，第二個命令是針對 Azure PowerShell 1.0。 Azure PowerShell 1.0 命令中一律有 "Az"。
Get-AzureStreamAnalyticsJob | Get-AzStreamAnalyticsJob
列出 Azure 訂用帳戶或指定的資源群組中定義的所有「串流分析」工作，或取得與資源群組內特定工作相關的工作資訊。
範例 1
Azure PowerShell 0.9.8：
Get-AzureStreamAnalyticsJob
Azure PowerShell 1.0：
Get-AzStreamAnalyticsJob
此 PowerShell 命令會傳回 Azure 訂用帳戶中所有「串流分析」工作的相關資訊。
範例 2
Azure PowerShell 0.9.8：
Get-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US
Azure PowerShell 1.0：
Get-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US
此 PowerShell 命令會傳回資源群組 StreamAnalytics-Default-Central-US 中所有串流分析工作的相關資訊。
範例 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
此 PowerShell 命令會傳回 StreamAnalytics-Default-Central-US 資源群組中 StreamingJob 串流分析工作的相關資訊。
Get-AzureStreamAnalyticsInput | Get-AzStreamAnalyticsInput
列出指定串流分析工作中定義的所有輸入，或取得特定輸入的相關資訊。
範例 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
此 PowerShell 命令會傳回在 StreamingJob 工作中定義的所有輸入的相關資訊。
範例 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
此 PowerShell 命令會傳回在 StreamingJob 工作中定義，名為 EntryStream 之輸入的相關資訊。
Get-AzureStreamAnalyticsOutput | Get-AzStreamAnalyticsOutput
列出指定串流分析工作中定義的所有輸出，或取得特定輸出的相關資訊。
範例 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
此 PowerShell 命令會傳回在 StreamingJob 工作中定義之輸出的相關資訊。
範例 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
此 PowerShell 命令會傳回在 StreamingJob 工作中定義，名為 Output 之輸出的相關資訊。
Get-AzureStreamAnalyticsQuota | Get-AzStreamAnalyticsQuota
取得指定區域之串流處理單位配額的相關資訊。
範例 1
Azure PowerShell 0.9.8：
Get-AzureStreamAnalyticsQuota -Location "Central US"
Azure PowerShell 1.0：
Get-AzStreamAnalyticsQuota -Location "Central US"
此 PowerShell 命令會傳回美國中部區域之串流單位的配額和使用量的相關資訊。
Get-AzureStreamAnalyticsTransformation | Get-AzStreamAnalyticsTransformation
取得在串流分析工作中定義之特定轉換的相關資訊。
範例 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
此 PowerShell 命令會傳回 StreamingJob 工作中名為 StreamingJob 之轉換的相關資訊。
New-AzureStreamAnalyticsInput | New-AzStreamAnalyticsInput
在串流分析工作內建立新的輸入，或更新現有的指定輸入。
您可以在 .json 檔案中或命令列上指定輸入的名稱。 若兩者皆指定，命令列上的名稱必須與檔案中的名稱相同。
如果您指定已存在的輸入，但沒有指定 –Force 參數，此 Cmdlet 會詢問是否要取代現有的輸入。
如果您指定 –Force 參數，並指定現有的輸入名稱，則未經確認就會取代輸入。
如需 JSON 檔案結構和內容的詳細資訊，請參閱串流分析管理 REST API 參考文件庫的建立輸入 (Azure 串流分析) 一節。
範例 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"
此 PowerShell 命令會透過 Input.json 檔案建立新的輸入。 如果輸入定義檔中已經定義指定名稱的現有輸入，Cmdlet 會詢問是否要取代它。
範例 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
此 PowerShell 命令會在名為 EntryStream 的工作中建立新的輸入。 如果已經定義此名稱的現有輸入，Cmdlet 會詢問是否要取代它。
範例 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
此 PowerShell 命令會使用檔案的定義取代名為 EntryStream 的現有輸入來源的定義。
New-AzureStreamAnalyticsJob | New-AzStreamAnalyticsJob
在 Microsoft Azure 中建立新的串流分析工作，或更新現有指定工作的定義。
您可以在 .json 檔案中或命令列上指定工作的名稱。 若兩者皆指定，命令列上的名稱必須與檔案中的名稱相同。
如果您指定已存在的工作名稱，但沒有指定 –Force 參數，此 Cmdlet 會詢問是否要取代現有的工作。
如果您指定 –Force 參數，並指定現有的工作名稱，則未經確認就會取代工作定義。
如需 JSON 檔案結構和內容的詳細資訊，請參閱串流分析管理 REST API 參考文件庫的建立串流分析作業一節。
範例 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"
此 PowerShell 命令會透過 JobDefinition.json 中的定義建立新的工作。 如果輸出定義檔中已經定義了指定名稱的現有輸出，Cmdlet 會詢問是否要取代它。
範例 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
此 PowerShell 命令會取代 StreamingJob 的工作定義。
New-AzureStreamAnalyticsOutput | New-AzStreamAnalyticsOutput
在串流分析工作內建立新的輸出，或更新現有的輸出。
您可以在 .json 檔案中或命令列上指定輸出的名稱。 若兩者皆指定，命令列上的名稱必須與檔案中的名稱相同。
如果您指定已存在的輸出，但沒有指定 –Force 參數，此 Cmdlet 會詢問是否要取代現有的輸出。
如果您指定 –Force 參數，並指定現有的輸出名稱，則未經確認就會取代輸出。
如需 JSON 檔案結構和內容的詳細資訊，請參閱串流分析管理 REST API 參考文件庫的建立輸出 (Azure 串流分析) 一節。
範例 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
此 PowerShell 命令會在 StreamingJob 工作中建立名為「output」的新輸出。 如果已經定義此名稱的現有輸出，Cmdlet 會詢問是否要取代它。
範例 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
此 PowerShell 命令會取代 StreamingJob 工作中「output」的定義。
New-AzureStreamAnalyticsTransformation | New-AzStreamAnalyticsTransformation
在串流分析工作內建立新的轉換，或更新現有的轉換。
您可以在 .json 檔案中或命令列上指定轉換的名稱。 若兩者皆指定，命令列上的名稱必須與檔案中的名稱相同。
如果您指定已存在的轉換，但沒有指定 –Force 參數，此 Cmdlet 會詢問是否要取代現有的轉換。
如果您指定 –Force 參數，並指定現有的轉換名稱，則未經確認就會取代轉換。
如需 JSON 檔案結構和內容的詳細資訊，請參閱串流分析管理 REST API 參考文件庫的建立轉換 (Azure 串流分析) 一節。
範例 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
此 PowerShell 命令會在 StreamingJob 工作中建立名為 StreamingJobTransform 的新轉換。 如果已經使用此名稱定義現有的轉換，Cmdlet 會詢問是否要取代它。
範例 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
此 PowerShell 命令會取代 StreamingJob 工作中 StreamingJobTransform 的定義。
Remove-AzureStreamAnalyticsInput | Remove-AzStreamAnalyticsInput
以非同步方式從 Microsoft Azure 中的 Stream Analytics 作業刪除特定的輸入。
如果您指定 –Force 參數，則未經確認就會刪除輸入。
範例 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
此 PowerShell 命令會移除 StreamingJob 工作中的 EventStream 輸入。
Remove-AzureStreamAnalyticsJob | Remove-AzStreamAnalyticsJob
以非同步方式從 Microsoft Azure 中刪除特定的 Stream Analytics 作業。
如果您指定 –Force 參數，則未經確認就會刪除作業。
範例 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
此 PowerShell 命令會移除 StreamingJob 工作。
Remove-AzureStreamAnalyticsOutput | Remove-AzStreamAnalyticsOutput
以非同步方式從 Microsoft Azure 中的 Stream Analytics 作業刪除特定的輸出。
如果您指定 –Force 參數，則未經確認就會刪除輸出。
範例 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
此 PowerShell 命令會移除 StreamingJob 工作中的 Output 輸出。
Start-AzureStreamAnalyticsJob | Start-AzStreamAnalyticsJob
以非同步方式部署和啟動 Microsoft Azure 中的 Stream Analytics 作業。
範例 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
此 PowerShell 命令會啟動自訂輸出開始時間設為 2012 年 12 月 12 日 12:12:12 UTC 的 StreamingJob 工作。
Stop-AzureStreamAnalyticsJob | Stop-AzStreamAnalyticsJob
以非同步方式停止在 Microsoft Azure 中執行 Stream Analytics 作業，並取消配置正在使用的資源。 透過 Azure 入口網站和管理 API 仍可使用訂用帳戶內的該工作定義與中繼資料，也因此可以編輯和重新啟動工作。 您將不需要對處於已停止狀態的工作支付費用。
範例 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
此 PowerShell 命令會停止 StreamingJob 工作。
Test-AzureStreamAnalyticsInput | Test-AzStreamAnalyticsInput
測試 Stream Analytics 連線到指定輸入的能力。
範例 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
此 PowerShell 命令會測試 StreamingJob 中 EntryStream 輸入的連接狀態。
Test-AzureStreamAnalyticsOutput | Test-AzStreamAnalyticsOutput
測試 Stream Analytics 連線到指定輸出的能力。
範例 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
此 PowerShell 命令會測試 StreamingJob 中 Output 輸出的連接狀態。
取得支援
如需進一步的協助，請嘗試 Azure 串流分析的 Microsoft 問與答頁面。