SecDesc_Tool for Managing SharePoint Portal Server Security (321227)



The information in this article applies to:

  • Microsoft SharePoint Portal Server 2001 SP1

This article was previously published under Q321227

SUMMARY

SharePoint Portal Server (SPS) includes a tool called SecDesc_Tool. You can use SecDesc_Tool to display and manage security descriptors on workspaces.

MORE INFORMATION

SecDesc_Tool is located on the SPS CD in the Support\Tools folder. SecDesc_Tool is a command-line tool. To use SecDesc_Tool, you must first bind to a URL. SecDesc_Tool accepts both HTTP and file style URLs, as in the following examples:

secdesc_tool.exe exoledb.binder http:\\server name\workspace name\documents\document name

-or-

secdesc_tool exoledb.binder file://./backofficestorage/localhost/sharepoint portal server/workspaces/workspace name/Documents/document name

After you have connected to a URL, type ? for help.

The following is a summary of some of the commands:
  • v
    Expands and displays the security descriptor for the item, expanding each ACE and resolving each SID.
  • r
    Displays the security descriptor without expansion. This is the same information that is displayed when you first connect.
  • V
    Same as v, but V expands roles.
  • ? command
    Prints usage for a command. For example, ? d prints the following:
    Delete ace from DACL at specified index
    Usage: d #
    where: # - ACE's index
    eg: d 0
    					
  • q
    Quits the tool.

Notes

To use SecDesc_Tool with exoledb.binder, exoledb must be present and registered on the computer. Because Microsoft does not recommend exoledb for remote use, the URL must also point to the local computer. If the URL does not also point to the local computer, you receive the following error message:
CLSIDFromProgID failed: 0x800401f3
RetrieveBinaryProp: 0x800401f3 Menu: 0x800401f3
If you use an incorrect URL, you receive the following error message:
Bind failed: 0x80040e19
RetrieveBinaryProp: 0x80040e19
Menu: 0x80040e19
For additional information about tools that are included with SPS, click the article number below to view the article in the Microsoft Knowledge Base:

318468 SPS: Contents of the Support Tools ToolsHowTo.txt File


Modification Type:MinorLast Reviewed:3/4/2004
Keywords:kbinfo KB321227