New-​Azure​Rm​Stream​Analytics​Transformation

Creates or updates a transformation within a job.

Syntax

New-AzureRmStreamAnalyticsTransformation
   [-ResourceGroupName] <String>
   [-JobName] <String>
   [[-Name] <String>]
   [-File] <String>
   [-Force]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

The New-AzureRmStreamAnalyticsTransformation cmdlet creates a transformation within a Stream Analytics job or updates the existing transformation. The name of the transformation can be specified in the .JSON file or on the command line. If both are specified, the name on command line must match the name in the file.

If you specify a transformation that already exists and do not specify the Force parameter, the cmdlet will ask whether or not to replace the existing transformation.

If you specify the Force parameter and specify an existing transformation name, the transformation will be replaced without confirmation.

Examples

EXAMPLE 1: Create or replace a transformation in a job

PS C:\>New-AzureRmStreamAnalyticsTransformation -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\Transformation.json" -JobName "StreamingJob" -Name "StreamingJobTransform"

This command creates a transformation called StreamingJobTransform in the job called StreamingJob. If an existing transformation is already defined with that name, the cmdlet will ask whether or not to replace it.

EXAMPLE 2: Replace a transformation in a job

PS C:\>New-AzureRmStreamAnalyticsTransformation -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\Transformation.json" -JobName "StreamingJob" -Name "StreamingJobTransform" -Force

This command replaces the definition of StreamingJobTransform in the job StreamingJob without confirmation.

Required Parameters

-File

Specifies the path to a JSON file that contains the JSON representation of the Azure Stream Analytics transformation to create.

Type:String
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobName

Specifies the name of the Azure Stream Analytics job under which to create the Azure Stream Analytics transformation.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ResourceGroupName

Specifies the name of the resource group under which to create the Azure Stream Analytics transformation.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name of the Azure Stream Analytics transformation to create.

Type:String
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.Azure.Commands.StreamAnalytics.Models.PSTransformation