Web Deploy Link Extensions

Applies To: Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, Windows Vista, Windows XP

Link extensions include data that would not normally be included by a provider in a Web Deploy operation. Link extensions and providers work together to create a view of a Web server that can be dumped, archived, or synchronized. Link extensions are executed for all Web Deploy verbs, including dump operations.

The following table lists the Web Deploy link extensions and their descriptions.

Link Extension Description

AppPool

Includes the application pool associated with the specified Web application.

AppPoolExtension

Includes the application pool associated with the specified Web application.

CertificateExtension

When an SSL certificate hash is detected in the IIS configuration, includes the associated certificate. Enabling this link extension will include all certificates associated with your Web application and the certificate path information in each certificate. These certificates can be HTTPS certificates from a local certification authority or signed certificates from external certification authorities like Verisign.

ContentExtension

Includes the contents of a virtual directory in an operation whenever a virtualDirectory configuration element or VirtualDir metabase path is detected.

FrameworkConfigExtension

Includes the configuration in the Machine.config or root Web.config files if location tags occur in those configuration files that are specific to the Web site. The Machine.config and root Web.config files that correspond to the Framework version of the Web application will be included.

Note
The Machine.config and root Web.config files are located in the %windir%\Microsoft.NET\Framework\<frameworkversion>\CONFIG directory.

HttpCertConfigExtension

Includes HTTP.SYS server certificate configuration and certificate path information when an SSL binding for an IIS site is detected.

You can use the -enableLink  and -disableLink  settings to enable or disable a Web Deploy link extension. For example, if you specify -disableLink:ContentExtension on the command line, you can prevent content from being included in a sync operation. This enables you to synchronize two Web servers without moving any content.

Warning

You cannot enable or disable link extensions when synchronizing from a package or archiveDir provider.

Important

You cannot edit, modify, or add new Web Deploy link extensions. Because link extensions rely on providers to retrieve data, they are limited by the capabilities of the providers they use.

See Also

Web Deploy Command Line Syntax

Web Deploy Operations

Web Deploy Operation Settings

Web Deploy Rules

Web Deploy Providers

Web Deploy Provider Settings