New-​Azure​Rm​Ml​Web​Service

Creates a new web service.

Syntax

New-AzureRmMlWebService
   -DefinitionFile <String>
   [-Force]
   -Location <String>
   -Name <String>
   -ResourceGroupName <String>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
New-AzureRmMlWebService
   [-Force]
   -Location <String>
   -Name <String>
   -NewWebServiceDefinition <WebService>
   -ResourceGroupName <String>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Creates an Azure Machine Learning web service in an existing resource group. If a web service with the same name exists in the resource group, the call acts as an update operation and the existing web service is overwritten.

Examples

-------------------------- Example 1: Create a new service from a Json file based definition --------------------------

@{paragraph=PS C:\>}

New-AzureRmMlWebService -ResourceGroupName "myresourcegroup" -Name "mywebservicename" -Location "South Central US" -DefinitionFile "C:\mlservice.json"

Creates a new Azure Machine Learning web service named "mywebservicename" in the "myresourcegroup" group and South Central US region, based on the definition present in the referenced json file.

-------------------------- Example 2: Create a new service from an object instance --------------------------

@{paragraph=PS C:\>}

New-AzureRmMlWebService -ResourceGroupName "myresourcegroup" -Name "mywebservicename" -Location "South Central US" -NewWebServiceDefinition $serviceDefinitionObject

You can obtain a web service object instance to customize before publishing as a resource by using the Import-AzureRmMlWebService cmdlet.

Required Parameters

-DefinitionFile

Specifes the path to the file containing the JSON format definition of the web service. You can find the latest specification for the web service definition in the swagger spec under https://github.com/Azure/azure-rest-api-specs/tree/master/arm-machinelearning.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Location

The region of the web service. Enter an Azure data center region, such as "West US" or "Southeast Asia". You can place a web service in any region that supports resources of that type. The web service does not have to be in the same region your Azure subscription or the same region as its resource group. Resource groups can contain web services from different regions. To determine which regions support each resource type, use the Get-AzureRmResourceProvider with the ProviderNamespace parameter cmdlet.

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

The name for the web service. The name must be unique in the resource group.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewWebServiceDefinition

The definition for the new web service, containing all the properties that make up the service. This parameter is required and represents an instance of the Microsoft.Azure.Management.MachineLearning.WebServices.Models.WebService class. You can find the latest specification for the web service definition in the swagger spec under https://github.com/Azure/azure-rest-api-specs/blob/master/arm-machinelearning/2017-01-01/swagger/webservices.json.

Type:WebService
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ResourceGroupName

The resource group in which to place the web service. Enter an Azure data center region, such as "West US" or "Southeast Asia". You can place a web service in any region that supports resources of that type. The web service does not have to be in the same region your Azure subscription or the same region as its resource group. Resource groups can contain web services from different regions. To determine which regions support each resource type, use the Get-AzureRmResourceProvider with the ProviderNamespace parameter cmdlet.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

Do not ask for confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
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:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.Azure.Management.MachineLearning.WebServices.Models.WebService

A summary description of the Azure Machine Learning web service. Similar to the description returned by calling the Get-AzureRmMlWebService cmdlet on an existing web service. This description does not contain sensitive properties such as storage account's credentials and the service's access keys.

Notes

Keywords: azure, azurerm, arm, resource, management, manager, machine, machine learning, azureml