< Back
New-AzureRmMlWebService
Post
NAME New-AzureRmMlWebService
SYNOPSIS
Creates a new web service.
SYNTAX
New-AzureRmMlWebService [-DefaultProfile <IAzureContextContainer>] -DefinitionFile <String> [-Force] -Location <String> -Name <String>
-ResourceGroupName <String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmMlWebService [-DefaultProfile <IAzureContextContainer>] [-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.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DefinitionFile <String>
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 ... nelearning.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Do not ask for confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Location <String>
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
The name for the web service. The name must be unique in the resource group.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-NewWebServiceDefinition <WebService>
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 ... vices.json.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-ResourceGroupName <String>
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
WebService
Parameter 'NewWebServiceDefinition' accepts value of type 'WebService' from the pipeline
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
-------------------------- Example 1: Create a new service from a Json file based definition --------------------------
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 --------------------------
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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... webservice
SYNOPSIS
Creates a new web service.
SYNTAX
New-AzureRmMlWebService [-DefaultProfile <IAzureContextContainer>] -DefinitionFile <String> [-Force] -Location <String> -Name <String>
-ResourceGroupName <String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmMlWebService [-DefaultProfile <IAzureContextContainer>] [-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.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DefinitionFile <String>
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 ... nelearning.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Do not ask for confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Location <String>
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
The name for the web service. The name must be unique in the resource group.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-NewWebServiceDefinition <WebService>
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 ... vices.json.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-ResourceGroupName <String>
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
WebService
Parameter 'NewWebServiceDefinition' accepts value of type 'WebService' from the pipeline
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
-------------------------- Example 1: Create a new service from a Json file based definition --------------------------
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 --------------------------
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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... webservice