Modifier

Partager via


New-AzMlWebService

Creates a new web service.

Syntax

New-AzMlWebService
   -ResourceGroupName <String>
   -Location <String>
   -Name <String>
   -DefinitionFile <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzMlWebService
   -ResourceGroupName <String>
   -Location <String>
   -Name <String>
   -NewWebServiceDefinition <WebService>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<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

New-AzMlWebService -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

New-AzMlWebService -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-AzMlWebService cmdlet.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefinitionFile

Specifies 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/blob/master/specification/machinelearning/resource-manager/Microsoft.MachineLearning/.

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

-Force

Do not ask for confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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-AzResourceProvider with the ProviderNamespace parameter cmdlet.

Type:String
Position:Named
Default value:None
Required:True
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
Required:True
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/specification/machinelearning/resource-manager/Microsoft.MachineLearning/stable/2017-01-01/webservices.json.

Type:Microsoft.Azure.Management.MachineLearning.WebServices.Models.WebService
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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-AzResourceProvider with the ProviderNamespace parameter cmdlet.

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

Inputs

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

Outputs

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

Notes

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