windows-itpro-docs/mdop/medv-v2/configuring-advanced-settings-by-using-windows-powershell.md
2019-08-09 14:32:29 -07:00

113 lines
4.2 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Configuring Advanced Settings by Using Windows PowerShell
description: Configuring Advanced Settings by Using Windows PowerShell
author: levinec
ms.assetid: 437a31cc-2a11-456f-b448-b0b869fb53f7
ms.reviewer:
manager: dansimp
ms.author: ellevin
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
ms.sitesec: library
ms.prod: w10
ms.date: 06/16/2016
---
# Configuring Advanced Settings by Using Windows PowerShell
The MED-V workspace package that you create includes a Windows PowerShell script (.ps1) file that you can edit before you test and deploy your MED-V workspace package. This section provides information and guidance to help you manage MED-V configuration settings by using Windows PowerShell before you deploy the MED-V workspaces.
## Using Windows PowerShell Cmdlets in MED-V
The following Windows PowerShell cmdlets are available in Microsoft Enterprise Desktop Virtualization (MED-V) 2.0:
**New-MedvConfiguration**
**Export-MedvConfiguration**
**New-MedvWorkspace**
**Export-MedvWorkspace**
To access Windows PowerShell cmdlets for MED-V, open Windows PowerShell and type the following command to import the MED-V modules.
``` syntax
Import-Module microsoft.medv
```
After the modules are imported, you can access inline help for the cmdlets by using the standard Windows PowerShell Help commands, **man** or **get-help**. For example, to access a description of the **New-MedvConfiguration** cmdlet including a complete list of available parameters, type the following command.
``` syntax
get-help New-MedvConfiguration
```
You can also view help for specific parameters. For example, to view help for the parameter VmMemory, type the following:
``` syntax
get-help New-MedvConfiguration -parameter VmMemory
```
To view a list of all MED-V configuration settings and their defaults, type the following command.
``` syntax
New-MedvConfiguration -ForceDefaults
```
To view a list of all MED-V configuration settings and their current values, type the following command.
``` syntax
gwmi -Class "Setting” -Namespace "root/microsoft/medv”
```
## Creating a MED-V Workspace with Custom Settings
After you successfully create a MED-V workspace package by using the MED-V Workspace Packager, a Windows PowerShell script is generated in the folder you specified for saving your packager files. The contents of this script show some of the available MED-V configuration settings that you can edit.
Following these steps, you can customize the script and then run it in Windows PowerShell to create a MED-V workspace with the new settings.
**Important**  
Run Windows PowerShell with administrative credentials, and ensure that the Windows PowerShell execution policy allows the running of scripts.
1. Edit the Windows PowerShell script that was generated by the MED-V Workspace Packager, or author a new script with the configuration settings that you want.
2. Run Windows PowerShell with administrative credentials and at the command prompt, type the following command.
``` syntax
& “.\<workspacename>.ps1”
```
This command runs the Windows PowerShell script and runs the **New-MedvWorkspace** cmdlet to generate a new MED-V workspace package. The new packager files are saved in the folder that you originally specified for storing your MED-V Workspace Packager files. For additional help about this cmdlet, see the Windows PowerShell Help.
## Exporting a MED-V Configuration to a Registry File
You can update MED-V configuration settings after the MED-V workspace is installed. Use the **New-MedvConfiguration** cmdlet to specify the parameters that you want to change. For example, to create a registry file that changes the virtual machine memory setting, type the following commands.
``` syntax
New-MedvConfiguration -VmMemory 1024 | Export-MedvConfiguration -Path c:\medvConfiguration\myConfig.reg
```
You can import the resultant registry file from the host computer to a MED-V workspace to apply the new configuration settings.
## Related topics
[Managing MED-V Workspace Configuration Settings](managing-med-v-workspace-configuration-settings.md)
[Test And Deploy the MED-V Workspace Package](test-and-deploy-the-med-v-workspace-package.md)