New-CMAppVVirtualEnvironment

Creates an App-V virtual environment.

Syntax

New-CMAppVVirtualEnvironment
   -ApplicationGroup <VirtualEnvironmentGroup[]>
   [-Confirm]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-WhatIf]
   [<CommonParameters>]

Description

The New-CMAppVVirtualEnvironment cmdlet creates an Microsoft Application Virtualization (App-V) virtual environment in Microsoft System Center Configuration Manager. App-V virtual environments in System Center Configuration Manager enable deployed virtual applications to share the same file system and registry on client computers.

Examples

Example 1: Create an App-V virtual environment

PS C:\> $Dti = Get-CMAppV5XDeploymentTypeItem -ApplicationName "App01d2012" -DeploymentTypeName "7Zip - Microsoft Application Virtualization 5"
PS C:\> $Veg = New-CMVirtualEnvironmentGroup -Name "Venvgroup01" -DeploymentType $Dti
PS C:\> New-CMAppVVirtualEnvironment -Name "CMAppVenv01" -Description "App-V virtual environment" -ApplicationGroup $Veg

This first command uses the Get-CMAppV5XDeploymentTypeItem cmdlet gets the deployment type named 7Zip - Microsoft Application Virtualization 5 in the application named App01d2012. The command stores the result in the $Dti variable.

This second command creates an application group named Venvgroup01 for the deployment type stored in $Dti. The command stores the result in the $Veg variable.

This third command creates an App-V virtual environment named CMAppVenv01 for the application group stored in $Veg.

Required Parameters

-ApplicationGroup

Specifies an array of application groups to add to the App-V virtual environment. To obtain an application group, use the New-CMVirtualEnvironmentGroup cmdlet.

Type:VirtualEnvironmentGroup[]
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies a name for the App-V virtual environment.

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

Specifies a description for the App-V virtual environment.

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

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

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