title: PowerShell module for Machine Learning | Microsoft Docs description: The PowerShell module for Azure Machine Learning is available in public preview mode. Use PowerShell to create and manage workspaces, experiments, web services, and more. keywords: experiment,linear regression,machine learning algorithms,machine learning tutorial,predictive modeling techniques,data science experiment services: machine-learning documentationcenter: '' author: hning86 manager: jhubbard editor: cgronlun
ms.assetid: a9001cc2-3aa0-47e1-b175-1f76408ba1d1 ms.service: machine-learning ms.workload: data-services ms.tgt_pltfrm: na ms.devlang: na ms.topic: article ms.date: 08/05/2016 ms.author: garye;haining
The PowerShell module for Azure Machine Learning is a powerful tool that allows you to use Windows PowerShell to manage workspaces, experiments, datasets, web serivces, and more.
You can view the documentation and download the module, along with the full source code, at https://aka.ms/amlps.
The Machine Learning PowerShell module is a .NET-based DLL module that allows you to fully manage Azure Machine Learning workspaces, experiments, datasets, web services, and web service endpoints from Windows PowerShell. Along with the module, you can download the full source code which includes a cleanly-separated C# API layer. This means you can reference this DLL from your own .NET project and manage Azure Machine Learning through .NET code. In addition, the DLL depends on underlying REST APIs that you can leverage directly from your favorite client.
Here are some of the tasks you can perform with this PowerShell module. Check out the full documentation for these and many more functions.
- Provision a new workspace using a management certificate (New-AmlWorkspace)
- Export and import a JSON file representing an experiment graph (Export-AmlExperimentGraph and Import-AmlExperimentGraph)
- Run an experiment (Start-AmlExperiment)
- Create a web service out of a predictive experiment (New-AmlWebService)
- Create a new endpoint on a published web service (Add-AmlWebServiceEndpoint)
- Invoke an RRS and/or BES web service endpoint (Invoke-AmlWebServiceRRSEndpoint and Invoke-AmlWebServicBESEndpoint)
Here's a quick example of using PowerShell to run an existing experiment:
#Find the first Experiment named “xyz”
$exp = (Get-AmlExperiment | where Description -eq ‘xyz’)[0]
#Run the Experiment
Start-AmlExperiment -ExperimentId $exp.ExperimentId
For a more in-depth use case, see this article on using the PowerShell module to automate a very commonly-requested task: Create many Machine Learning models and web service endpoints from one experiment using PowerShell.
To get started with Machine Learning PowerShell, download the release package from GitHub and follow the instructions for installation. You'll need to unblock the downloaded/unzipped DLL and then import it into your PowerShell environment. Most of the cmdlets require that you supply the workspace ID, the workspace authorization token, and the Azure region that the workspace is in. The simplest way to provide these is through a default config.json file, which is covered in detail in the installation instructions. Of course, you can also clone the git tree and modify/compile the code locally using Visual Studio.
The PowerShell module will continue to be improved and expanded during this preview period. Keep an eye on the Cortana Intelligence and Machine Learning Blog for more news and information.