Providing Links on the Home Page or Remote Access Page

Switch View :
Classic
Lightweight
ScriptFree
Providing Links on the Home Page or Remote Access Page

You can provide links to Web sites on either the Windows Home Server home page or the remote access page. The links appear when a user logs on to your home server. To provide these links, edit the websites.xml files. These files are installed as part of the Windows Home Server, and are located in the C:\inetpub\home and the C:\inetpub\remote folders.

This section describes the websites.xml schema, and provides an XML code snippet to demonstrate how to specify Web site links in the websites.xml file.

Websites.xml Schema

Element Description

WebSites

Container parent element for the WebSite element. This element is required and can only occur once in the websites.xml file.

WebSite

Singleton element that specifies the HTTP URI/URL of a Web site of which to add a link for in the home or remote access page.

The following attributes are required for this element:

  • name: the label to associate with the URL of the Web site.

  • uri: the URI of the Web site.

  • imageUrl: URI of an image to associate with the link. This image must be in a format supported by IIS, such as .gif, .jpg, .ico, and .png.

  • absolute: Boolean value that indicates whether the URI string provided to uri is an absolute (qualified full URI such as http://www.microsoft.com) or a relative URI (a location on the local web server). A value of true indicates that the URI is absolute; false indicates relative.

Cc766796.Caution(en-us,MSDN.10).gifCaution
Content in this file can potentially be viewed (but not modified) by unauthenticated users over the Internet. Do not put any private information in this file.

Example

The following XML snippet demonstrates how to specify Web site links in the websites.xml file:

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<WebSites> 
 <WebSite name="Microsoft Home Page" 
               uri="http://www.microsoft.com"   
               imageUrl="\home\microsoft_banner.png" 
               absolute="true"/>
  <WebSite name="My Vacation Pictures" 
               uri="\home\vacation\index.htm" 
               imageUrl="\home\my_vacation_icon.ico"     
               absolute="false"/>
</WebSites>

See Also