Set-CMAppVVirtualEnvironment

Set-CMAppVVirtualEnvironment

Changes settings for virtual applications that you have deployed by using Configuration Manager.

Syntax

Parameter Set: SetSecurityScopeById
Set-CMAppVVirtualEnvironment -Id <String[]> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-SecuredScopeNames <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetById
Set-CMAppVVirtualEnvironment -Id <String[]> [-AddApplicationGroup <VirtualEnvironmentGroup[]> ] [-Description <String> ] [-NewName <String> ] [-RemoveApplicationGroup <VirtualEnvironmentGroup[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByName
Set-CMAppVVirtualEnvironment -Name <String[]> [-AddApplicationGroup <VirtualEnvironmentGroup[]> ] [-Description <String> ] [-NewName <String> ] [-RemoveApplicationGroup <VirtualEnvironmentGroup[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByValue
Set-CMAppVVirtualEnvironment -InputObject <IResultObject> [-AddApplicationGroup <VirtualEnvironmentGroup[]> ] [-Description <String> ] [-NewName <String> ] [-RemoveApplicationGroup <VirtualEnvironmentGroup[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByName
Set-CMAppVVirtualEnvironment -Name <String[]> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-SecuredScopeNames <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByValue
Set-CMAppVVirtualEnvironment -InputObject <IResultObject> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMAppVVirtualEnvironment cmdlet changes settings for one or more Microsoft Application Virtualization (App-V) virtual environment objects from Microsoft System Center 2012 Configuration Manager. You can specify App-V environments by name or ID.

Parameters

-AddApplicationGroup<VirtualEnvironmentGroup[]>

Specifies an array of application groups to add. Application groups contain multiple App-V deployment types that run in the same environment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Description<String>

Specifies a description for the App-V virtual environment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Id<String[]>

Specifies an array of IDs of virtual environments.

Aliases

CIId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies a virtual environment object for Configuration Manager. To obtain a virtual environment object, use the Get-CMAppVVirtualEnvironment cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of names of virtual environments.

Aliases

LocalizedDisplayName

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NewName<String>

Specifies a new name for a virtual environment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RemoveApplicationGroup<VirtualEnvironmentGroup[]>

Specifies an array of application groups to remove. Application groups contain multiple App-V deployment types that run in the same environment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecuredScopeNames<String>

Specifies the name of security scopes. A security scope can be Default or the name of a custom-created security scope.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeAction<SecurityScopeActionType>

Specifies the action to perform on the security scope. Acceptable values for this parameter are AddMembership and RemoveMembership.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeName<String>

Specifies the name of a security scope. Acceptable values for this parameter are Default or the name of a custom security scope.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Change virtual environment settings by using a name

This command removes the virtual environment named VMWin03 from the security scope named ClientSecGroup01.

PS C:\> Set-CMAppVVirtualEnvironment -Name "VMWin03" -SecurityScopeAction RemoveMembership -SecurityScopeName "ClientSecGroup01"

Get-CMAppVVirtualEnvironment

Remove-CMAppVVirtualEnvironment