< Back
Set-AppvClientConfiguration
Post
NAME Set-AppvClientConfiguration
SYNOPSIS
Applies configuration settings to the App-V Client.
SYNTAX
Set-AppvClientConfiguration [-AllowHighCostLaunch <Boolean>] [-AutoLoad <UInt32>] [-CertFilterForClientSsl <String>] [-EnableDynamicVirtualization
<Boolean>] [-EnablePackageScripts <Boolean>] [-EnablePublishingRefreshUI <Boolean>] [-ExperienceImprovementOptIn <Boolean>]
[-IgnoreLocationProvider <Boolean>] [-IntegrationRootGlobal <String>] [-IntegrationRootUser <String>] [-LocationProvider <String>] [-MigrationMode
<Boolean>] [-PackageInstallationRoot <String>] [-PackageSourceRoot <String>] [-ProcessesUsingVirtualComponents <String[]>]
[-ReestablishmentInterval <UInt32>] [-ReestablishmentRetries <UInt32>] [-ReportingDataBlockSize <UInt32>] [-ReportingDataCacheLimit <UInt32>]
[-ReportingEnabled <Boolean>] [-ReportingInterval <UInt32>] [-ReportingRandomDelay <UInt32>] [-ReportingServerURL <String>] [-ReportingStartTime
<UInt32>] [-RequirePublishAsAdmin <Boolean>] [-RoamingFileExclusions <String>] [-RoamingRegistryExclusions <String>] [-SharedContentStoreMode
<Boolean>] [-SupportBranchCache <Boolean>] [-VerifyCertificateRevocationList <Boolean>] [<CommonParameters>]
DESCRIPTION
The Set-AppvClientConfiguration cmdlet applies configuration settings to the Microsoft Application Virtualization (App-V) client. Each parameter
represents a setting that can be changed.
PARAMETERS
-AllowHighCostLaunch [<Boolean>]
Specifies whether virtualized applications are started on Windows 8 computers that are connected over a metered network connection, for
instance, 4G.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-AutoLoad [<UInt32>]
Specifies how new packages should be loaded automatically by App-V on a specific computer. The acceptable values for this parameter are:
-- 0 for None
-- 1 for Previously used
-- 2 for All
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CertFilterForClientSsl [<String>]
Specifies the path of a valid certificate in the certificate store.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-EnableDynamicVirtualization [<Boolean>]
Specifies whether to enable dynamic virtualization. Dynamic virtualization enables supported Shell Extensions, Browser Helper Objects, and
Active X controls to be virtualized and work with virtual applications.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-EnablePackageScripts [<Boolean>]
Specifies whether to enable the ability for scripts defined in the package manifest of configuration files to run.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-EnablePublishingRefreshUI [<Boolean>]
Specifies whether to enable the publishing refresh progress bar for the Client.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ExperienceImprovementOptIn [<Boolean>]
Specifies whether to opt in ($True) or opt out ($False) of the Customer Experience Improvement Program.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreLocationProvider [<Boolean>]
Specifies whether to force the client to ignore the Location Provider path and instead use the Package Source Root.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IntegrationRootGlobal [<String>]
Specifies the location to create symbolic links associated with the current version of a globally published package. All virtual application
extensions, for example shortcuts and file type associations, use this path. If you do not specify a path, symbolic links are not be used when
you publish the package.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IntegrationRootUser [<String>]
Specifies the location to create symbolic links associated with the current version of a per-user published package. All virtual application
extensions, for example shortcuts and file type associations, use this path. If you do not specify a path, symbolic links will not be used
when you publish the package.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-LocationProvider [<String>]
Specifies the class ID (CLSID) for a compatible implementation of the IAppvPackageLocationProvider interface.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-MigrationMode [<Boolean>]
Specifies whether to use migration mode. Migration mode allows the App-V client to control shortcuts and FTAs for packages published using an
earlier version of App-V.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PackageInstallationRoot [<String>]
Specifies directory where all new applications and updates are installed.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PackageSourceRoot [<String>]
Specifies a value that overrides source location for downloading package content.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ProcessesUsingVirtualComponents [<String[]>]
Specifies a list of process paths which are candidates for using dynamic virtualization of supported shell extensions, browser helper objects,
and ActiveX controls. This parameter may contain wildcard characters. Only processes whose full path matches one of these items can use
dynamic virtualization.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReestablishmentInterval [<UInt32>]
Specifies the number of seconds between attempts to reestablish a dropped session. The acceptable values for this parameter are: between 0 and
3600.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReestablishmentRetries [<UInt32>]
Specifies the number of times to retry a dropped session. The acceptable values for this parameter are: between 0 and 99.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingDataBlockSize [<UInt32>]
Specifies the maximum size in bytes to transmit to the server for reporting upload requests. This can help avoid permanent transmission
failures when the log has reached a significant size. The acceptable values for this parameter are: between 1024 and unlimited.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingDataCacheLimit [<UInt32>]
Specifies the maximum size in megabytes (MB) of the XML cache for storing reporting information. The size applies to the cache in memory. When
the limit is reached, the log file rolls over. The acceptable values for this parameter are: between 0 and 1024.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingEnabled [<Boolean>]
Specifies whether to enable the client to return information to a reporting server.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingInterval [<UInt32>]
Specifies the retry interval that the client uses to resend data to the reporting server.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingRandomDelay [<UInt32>]
Specifies the maximum delay, in minutes, for data to be sent to the reporting server. When the scheduled task is started, the client generates
a random delay between 0 and ReportingRandomDelay and waits the specified duration before it sends data. This can help prevent collisions on
the server.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingServerURL [<String>]
Specifies the location on the reporting server where client information is saved.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingStartTime [<UInt32>]
Specifies the time to initiate the client to send data to the reporting server. The acceptable values for this parameter are: integers between
0-23 corresponding to the hour of the day. By default, the ReportingStartTime starts on the current day at 10 P.M or 22.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-RequirePublishAsAdmin [<Boolean>]
Specifies whether an unelevated user can publish registered App-V packages.
This parameter is applicable starting in App-V 5.0 SP3.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-RoamingFileExclusions [<String>]
Specifies the file paths relative to %userprofile% that do not roam with a user's profile, for example: 'desktop;my pictures'.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-RoamingRegistryExclusions [<String>]
Specifies the registry paths that do not roam with a user profile, for example 'software\\\\classes;software\\\\clients'.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SharedContentStoreMode [<Boolean>]
Specifies whether streamed package contents are not saved to the local hard disk.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SupportBranchCache [<Boolean>]
Specifies whether branch caching is turned on.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VerifyCertificateRevocationList [<Boolean>]
Specifies whether to verify Server certificate revocation status before steaming using HTTPS.
Required? false
Position? named
Default value none
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
Microsoft.AppvAgent.AppvClientConfiguration
OUTPUTS
Microsoft.AppvAgent.AppvClientConfiguration
This cmdlet returns an object that is displayed as a two column table. The first column contains the specific configuration and the second
column contains the associated current value.
In the case where the name/value option is passed, the cmdlet returns the same two column table, but only for the configuration requested.
NOTES
Before applying new configuration, the cmdlet checks if Group Policy already owns any configuration by checking
HKLM\\Software\\Policies\\Microsoft\\Application Virtualization. If any of the provided configuration is in the Group Policy registry node, the
cmdlet fails. If Group Policy does not own any of the supplied configuration, the settings are written to the HKLM\\Software\\Microsoft\\AppV
registry node. If the cmdlet is trying to modify multiple settings, if any are owned by Group Policy, the whole operation fails.
In the case where Group Policy owns the setting, the cmdlet returns the following error: The App-V configuration trying to be modified is
being managed by Group Policy. The cmdlet cannot perform the modification. An error code is returned.
If any of the provided configuration are not valid App-V Client settings, the cmdlet fails and returns an error.
The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns an error.
If the action to set a property fails, the cmdlet returns an error.
Example 1: Set a client configuration parameter
PS C:\\> Set-AppvClientConfiguration -parameter1 "parameterVal1"
This schematic example sets a particular client configuration parameter.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=827722
Get-AppvClientConfiguration
SYNOPSIS
Applies configuration settings to the App-V Client.
SYNTAX
Set-AppvClientConfiguration [-AllowHighCostLaunch <Boolean>] [-AutoLoad <UInt32>] [-CertFilterForClientSsl <String>] [-EnableDynamicVirtualization
<Boolean>] [-EnablePackageScripts <Boolean>] [-EnablePublishingRefreshUI <Boolean>] [-ExperienceImprovementOptIn <Boolean>]
[-IgnoreLocationProvider <Boolean>] [-IntegrationRootGlobal <String>] [-IntegrationRootUser <String>] [-LocationProvider <String>] [-MigrationMode
<Boolean>] [-PackageInstallationRoot <String>] [-PackageSourceRoot <String>] [-ProcessesUsingVirtualComponents <String[]>]
[-ReestablishmentInterval <UInt32>] [-ReestablishmentRetries <UInt32>] [-ReportingDataBlockSize <UInt32>] [-ReportingDataCacheLimit <UInt32>]
[-ReportingEnabled <Boolean>] [-ReportingInterval <UInt32>] [-ReportingRandomDelay <UInt32>] [-ReportingServerURL <String>] [-ReportingStartTime
<UInt32>] [-RequirePublishAsAdmin <Boolean>] [-RoamingFileExclusions <String>] [-RoamingRegistryExclusions <String>] [-SharedContentStoreMode
<Boolean>] [-SupportBranchCache <Boolean>] [-VerifyCertificateRevocationList <Boolean>] [<CommonParameters>]
DESCRIPTION
The Set-AppvClientConfiguration cmdlet applies configuration settings to the Microsoft Application Virtualization (App-V) client. Each parameter
represents a setting that can be changed.
PARAMETERS
-AllowHighCostLaunch [<Boolean>]
Specifies whether virtualized applications are started on Windows 8 computers that are connected over a metered network connection, for
instance, 4G.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-AutoLoad [<UInt32>]
Specifies how new packages should be loaded automatically by App-V on a specific computer. The acceptable values for this parameter are:
-- 0 for None
-- 1 for Previously used
-- 2 for All
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CertFilterForClientSsl [<String>]
Specifies the path of a valid certificate in the certificate store.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-EnableDynamicVirtualization [<Boolean>]
Specifies whether to enable dynamic virtualization. Dynamic virtualization enables supported Shell Extensions, Browser Helper Objects, and
Active X controls to be virtualized and work with virtual applications.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-EnablePackageScripts [<Boolean>]
Specifies whether to enable the ability for scripts defined in the package manifest of configuration files to run.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-EnablePublishingRefreshUI [<Boolean>]
Specifies whether to enable the publishing refresh progress bar for the Client.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ExperienceImprovementOptIn [<Boolean>]
Specifies whether to opt in ($True) or opt out ($False) of the Customer Experience Improvement Program.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreLocationProvider [<Boolean>]
Specifies whether to force the client to ignore the Location Provider path and instead use the Package Source Root.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IntegrationRootGlobal [<String>]
Specifies the location to create symbolic links associated with the current version of a globally published package. All virtual application
extensions, for example shortcuts and file type associations, use this path. If you do not specify a path, symbolic links are not be used when
you publish the package.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-IntegrationRootUser [<String>]
Specifies the location to create symbolic links associated with the current version of a per-user published package. All virtual application
extensions, for example shortcuts and file type associations, use this path. If you do not specify a path, symbolic links will not be used
when you publish the package.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-LocationProvider [<String>]
Specifies the class ID (CLSID) for a compatible implementation of the IAppvPackageLocationProvider interface.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-MigrationMode [<Boolean>]
Specifies whether to use migration mode. Migration mode allows the App-V client to control shortcuts and FTAs for packages published using an
earlier version of App-V.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PackageInstallationRoot [<String>]
Specifies directory where all new applications and updates are installed.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PackageSourceRoot [<String>]
Specifies a value that overrides source location for downloading package content.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ProcessesUsingVirtualComponents [<String[]>]
Specifies a list of process paths which are candidates for using dynamic virtualization of supported shell extensions, browser helper objects,
and ActiveX controls. This parameter may contain wildcard characters. Only processes whose full path matches one of these items can use
dynamic virtualization.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReestablishmentInterval [<UInt32>]
Specifies the number of seconds between attempts to reestablish a dropped session. The acceptable values for this parameter are: between 0 and
3600.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReestablishmentRetries [<UInt32>]
Specifies the number of times to retry a dropped session. The acceptable values for this parameter are: between 0 and 99.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingDataBlockSize [<UInt32>]
Specifies the maximum size in bytes to transmit to the server for reporting upload requests. This can help avoid permanent transmission
failures when the log has reached a significant size. The acceptable values for this parameter are: between 1024 and unlimited.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingDataCacheLimit [<UInt32>]
Specifies the maximum size in megabytes (MB) of the XML cache for storing reporting information. The size applies to the cache in memory. When
the limit is reached, the log file rolls over. The acceptable values for this parameter are: between 0 and 1024.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingEnabled [<Boolean>]
Specifies whether to enable the client to return information to a reporting server.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingInterval [<UInt32>]
Specifies the retry interval that the client uses to resend data to the reporting server.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingRandomDelay [<UInt32>]
Specifies the maximum delay, in minutes, for data to be sent to the reporting server. When the scheduled task is started, the client generates
a random delay between 0 and ReportingRandomDelay and waits the specified duration before it sends data. This can help prevent collisions on
the server.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingServerURL [<String>]
Specifies the location on the reporting server where client information is saved.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ReportingStartTime [<UInt32>]
Specifies the time to initiate the client to send data to the reporting server. The acceptable values for this parameter are: integers between
0-23 corresponding to the hour of the day. By default, the ReportingStartTime starts on the current day at 10 P.M or 22.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-RequirePublishAsAdmin [<Boolean>]
Specifies whether an unelevated user can publish registered App-V packages.
This parameter is applicable starting in App-V 5.0 SP3.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-RoamingFileExclusions [<String>]
Specifies the file paths relative to %userprofile% that do not roam with a user's profile, for example: 'desktop;my pictures'.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-RoamingRegistryExclusions [<String>]
Specifies the registry paths that do not roam with a user profile, for example 'software\\\\classes;software\\\\clients'.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SharedContentStoreMode [<Boolean>]
Specifies whether streamed package contents are not saved to the local hard disk.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SupportBranchCache [<Boolean>]
Specifies whether branch caching is turned on.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VerifyCertificateRevocationList [<Boolean>]
Specifies whether to verify Server certificate revocation status before steaming using HTTPS.
Required? false
Position? named
Default value none
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
Microsoft.AppvAgent.AppvClientConfiguration
OUTPUTS
Microsoft.AppvAgent.AppvClientConfiguration
This cmdlet returns an object that is displayed as a two column table. The first column contains the specific configuration and the second
column contains the associated current value.
In the case where the name/value option is passed, the cmdlet returns the same two column table, but only for the configuration requested.
NOTES
Before applying new configuration, the cmdlet checks if Group Policy already owns any configuration by checking
HKLM\\Software\\Policies\\Microsoft\\Application Virtualization. If any of the provided configuration is in the Group Policy registry node, the
cmdlet fails. If Group Policy does not own any of the supplied configuration, the settings are written to the HKLM\\Software\\Microsoft\\AppV
registry node. If the cmdlet is trying to modify multiple settings, if any are owned by Group Policy, the whole operation fails.
In the case where Group Policy owns the setting, the cmdlet returns the following error: The App-V configuration trying to be modified is
being managed by Group Policy. The cmdlet cannot perform the modification. An error code is returned.
If any of the provided configuration are not valid App-V Client settings, the cmdlet fails and returns an error.
The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns an error.
If the action to set a property fails, the cmdlet returns an error.
Example 1: Set a client configuration parameter
PS C:\\> Set-AppvClientConfiguration -parameter1 "parameterVal1"
This schematic example sets a particular client configuration parameter.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=827722
Get-AppvClientConfiguration