Step 2: Configuring Windows SharePoint Services

Applies To: Windows Server 2008 R2

In this step, you will configure Windows SharePoint Services so that users in the CONTOSO domain can access RD Web Access by using Windows SharePoint Services. Use the following steps to configure Windows SharePoint Services:

  • Register the Web Part's assembly and namespace as a Safe Control.

  • Create folders to store the Web Part image files.

  • Add the Web Part to the default Windows SharePoint Services site.

  • Add Morgan Skinner to the Team Site Members group.

Register the Web Part's assembly and namespace as a Safe Control

As a security measure, Windows SharePoint Services requires that you register the RD Web Access Web Part's assembly and namespace as a Safe Control in the Web.config file of the server.

The following procedure shows how to register the Web Part's assembly as a Safe Control for Windows SharePoint Services sites that use the default port 80.

To register the Web Part's assembly and namespace as a Safe Control

  1. Log on to RDWA-SRV as CONTOSO\Administrator.

  2. Open an elevated command prompt. To do this, click Start, right-click Command Prompt, and then click Run as administrator.

  3. At the command prompt, type notepad %Systemdrive%\inetpub\wwwroot\wss\VirtualDirectories\80\web.config and then press ENTER.

  4. In the <SafeControls> section of the Web.config file, add the following line under the other SafeControl Assembly entries (as a single line):

    <SafeControl Assembly="TSPortalWebPart, Version=6.1.0.0, Culture=neutral,PublicKeyToken=31bf3856ad364e35" Namespace="Microsoft.TerminalServices.Publishing.Portal"TypeName="*" Safe="True" AllowRemoteDesigner="True" />

  5. On the File menu, click Save, and then close the file.

Note

The port_number placeholder represents the random port number that the SharePoint Central Administration site is configured to use; for example, port 36950. To determine the port number, either browse to the VirtualDirectories folder, or open Internet Information Services (IIS) Manager, locate and then click the SharePoint Central Administration v3 site, click Bindings in the Actions pane, and then view the port number in the Port column. (To open IIS Manager, click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.)

Create folders to store the Web Part image files

The icons shown in the Web part are cached on the RD Web Access server in a folder named Images and a folder named rdp. You must create these folders and give the Network Service account full control permissions so that the icons for the RemoteApp programs show up.

To create folders to store the Web Part image files

  1. Log on to RDWA-SRV as CONTOSO\Administrator.

  2. Open an elevated command prompt. To do this, click Start, right-click Command Prompt, and then click Run as administrator.

  3. Type mkdir "%SystemDrive%\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources\TSPortalWebPart\6.1.0.0__31bf3856ad364e35\images" and then press ENTER.

  4. Type mkdir "%SystemDrive%\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources\TSPortalWebPart\6.1.0.0__31bf3856ad364e35\rdp" and then press ENTER.

  5. Type cacls "%SystemDrive%\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources\TSPortalWebPart\6.1.0.0__31bf3856ad364e35\images” /T /E /P NetworkService:F and then press ENTER.

  6. Type cacls "%SystemDrive%\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources\TSPortalWebPart\6.1.0.0__31bf3856ad364e35\rdp” /T /E /P NetworkService:F and then press ENTER.

  7. Close the Command Prompt window.

Add the Web Part to the default Windows SharePoint Services site

To add the RD Web Access Web Part to a Windows SharePoint Services site, you must first add the Web Part to the Web Part Gallery for the site. Then, you can add the Web Part and configure it to point to a specific Remote Desktop Session Host (RD Session Host) server or RD Session Host server farm. If you have multiple RD Session Host servers, you can add multiple Web Parts to the page, each pointing to a different RD Session Host server or RD Session Host server farm.

Use the following procedure to add the Web part to the default Windows SharePoint Services site.

To add the Web Part to a Windows SharePoint Services site

  1. Log on to RDWA-SRV as CONTOSO\Administrator.

  2. In Internet Explorer, open the default Windows SharePoint Services site at the following location: https://localhost/.

  3. When you are prompted, enter the account credentials for CONTOSO\Administrator, and then click OK.

  4. In the upper-right corner, on the Site Actions tab, click Site Settings.

  5. Under Galleries, click Web Parts.

  6. Under the Web Part Gallery heading, click New.

  7. Select the check box next to Microsoft.TerminalServices.Publishing.Portal.TSPortalWebPart, and then click Populate Gallery.

  8. Click the Home tab.

  9. On the Site Actions tab, click Edit Page.

  10. Choose the location where you want to add the Web Part, and then click Add a Web Part.

  11. In the Add Web Parts -- Webpage Dialog dialog box, under the All Web Parts heading, select the TSPortalWebPart check box, and then click Add. The TSPortalWebPart Web Part will appear on the page.

  12. To configure the Web Part, click edit in the upper-right corner of the Web Part, and then click Modify Shared Web Part.

  13. In the RD Session Host server(s) or RemoteApp and Desktop Connection Management server name box, type rdsh-srv and then click OK.

  14. Click Exit Edit Mode.

Add Morgan Skinner to the Team Site Members group

In order for Morgan Skinner to be able to open the default Windows SharePoint Services Web site, you must add his user account to the Team Site Members group.

To add Morgan Skinner to the Team Site Members group

  1. Log on to RDWA-SRV as CONTOSO\Administrator.

  2. In Internet Explorer, open the default Windows SharePoint Services site at the following location: https://localhost/.

  3. When you are prompted, enter the account credentials for CONTOSO\Administrator, and then click OK.

  4. In the upper-right corner, on the Site Actions tab, click Site Settings.

  5. Under the Users and Permissions heading, click People and Groups.

  6. Click New, and then click Add Users.

  7. In the Users/Groups box, type contoso\mskinner and then click OK.

    You have configured Windows SharePoint Services. Now you can proceed to Step 3: Verifying Customization of Remote Desktop Web Access.