Set-AppvClientConfiguration

Letzte Aktualisierung: Dezember 2014

Betrifft: Application Virtualization 5.0, Application Virtualization 5.0 SP1, Application Virtualization 5.0 SP2, Application Virtualization 5.0 SP3

Set-AppvClientConfiguration

Applies configuration settings to the App-V Client.

Syntax

Parameter Set: Default
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 <Nullable [System.Boolean]> ] [-RoamingFileExclusions <String> ] [-RoamingRegistryExclusions <String> ] [-SharedContentStoreMode <Boolean> ] [-SupportBranchCache <Nullable [System.Boolean]> ] [-VerifyCertificateRevocationList <Boolean> ] [ <CommonParameters>]




Detaillierte Beschreibung

The Set-AppvClientConfiguration cmdlet applies configuration settings to the Microsoft Application Virtualization (App-V) client. Each parameter represents a setting that can be changed.

Parameter

-AllowHighCostLaunch<Boolean>

Specifies whether virtualized applications are launched on Windows 8 computers connected via a metered network connection (e.g. 4G).


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-AutoLoad<UInt32>

Specifies how new packages should be loaded automatically by App-V on a specific computer. Valid values are:

-- 0 for None
-- 1 for Previously used
-- 2 for All


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-CertFilterForClientSsl<String>

Specifies the path to a valid certificate in the certificate store.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-EnableDynamicVirtualization<Boolean>

Specifies whether to enable dynamic virtualization. Dynamic virtualization allows supported Shell Extensions, Browser Helper Objects, and Active X controls to be virtualized and work with virtual applications.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-EnablePackageScripts<Boolean>

Specifies whether to enable the ability for scripts defined in the package manifest of configuration files to run.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-EnablePublishingRefreshUI<Boolean>

Specifies whether to enable the publishing refresh progress bar for the Client.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ExperienceImprovementOptIn<Boolean>

Specifies whether to opt in ($True) or opt out ($False) of the Customer Experience Improvement Program.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-IgnoreLocationProvider<Boolean>

Specifies whether to force the client to ignore the Location Provider path and instead use the Package Source Root.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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, will point to this path. If you do not specify a path, symbolic links will not be used when you publish the package. For example: %allusersprofile%\Microsoft\AppV\Client\Integration.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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, will point to this path. If you do not specify a path, symbolic links will not be used when you publish the package. For example: %localappdata%\Microsoft\AppV\Client\Integration.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-LocationProvider<String>

Specifies the class ID (CLSID) for a compatible implementation of the IAppvPackageLocationProvider interface.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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 a previous version of App-V .


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-PackageInstallationRoot<String>

Specifies directory where all new applications and updates are installed.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-PackageSourceRoot<String>

Specifies a value that overrides source location for downloading package content.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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 wildcards. Only processes whose full path matches one of these items can use dynamic virtualization.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ReestablishmentInterval<UInt32>

Specifies the number of seconds between attempts to reestablish a dropped session. Valid values are: between 0 and 3600.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ReestablishmentRetries<UInt32>

Specifies the number of times to retry a dropped session. Valid values are: between 0 and 99.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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. Valid values are: between 1024 and unlimited.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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 will roll over. Valid values are: between 0 and 1024.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ReportingEnabled<Boolean>

Specifies whether to enable the client to return information to a reporting server.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ReportingInterval<UInt32>

Specifies the retry interval that the client uses to resend data to the reporting server.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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 sending data. This can help to prevent collisions on the server.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ReportingServerURL<String>

Specifies the location on the reporting server where client information is saved.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ReportingStartTime<UInt32>

Specifies the time to initiate the client to send data to the reporting server. Valid values 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.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-RequirePublishAsAdmin<Nullable [System.Boolean]>

(Applicable starting in App-V 5.0 SP3.) Specifies whether an unelevated user can publish registered App-V packages.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-RoamingFileExclusions<String>

Specifies the file paths relative to %userprofile% that do not roam with a user's profile. Example usage: -RoamingFileExclusions='desktop;my pictures'.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-RoamingRegistryExclusions<String>

Specifies the registry paths that do not roam with a user profile. Example usage: -RoamingRegistryExclusions=software\\classes;software\\clients.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-SharedContentStoreMode<Boolean>

Specifies whether streamed package contents are not saved to the local hard disk.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-SupportBranchCache<Nullable [System.Boolean]>

Specifies whether branch caching is turned on.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-VerifyCertificateRevocationList<Boolean>

Specifies whether to verify Server certificate revocation status before steaming using HTTPS.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

  • Microsoft.AppvAgent.AppvClientConfiguration

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

  • Microsoft.AppvAgent.AppvClientConfiguration

    The object 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.


Hinweise

  • 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 GP registry node, the cmdlet fail.s If GP does not own any of the supplied configuration, the settings are written to the HKLM\Software\Microsoft\AppV registry node. If the cmdlet is attempting to modify multiple settings, if any are owned by GP, the entire operation fails.

  • In the case where GP 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.

Beispiele

Example 1: Set a client configuration parameter

This schematic example sets a particular client configuration parameter.


PS C:\> Set-AppvClientConfiguration -parameter1 "parameterVal1"

Verwandte Themen

Community-Beiträge

HINZUFÜGEN
Anzeigen: