Displays the properties of a directory partition.

Dsget is a command-line tool that is built into Windows Server 2008. It is available if you have the Active Directory Domain Services (AD DS) server role installed. To use dsget, you must run the dsget command from an elevated command prompt. To open an elevated command prompt, click Start, right-click Command Prompt, and then click Run as administrator.

For examples of how to use this command, see Examples.

Syntax

dsget partition <ObjectDN> ... [-dn] [-qdefault] [-qtmbstnwt] [-topobjowner <Display>] [{-s <Server> | -d <Domain>}] [-u <UserName>] [-p {<Password> | *}] [-c] [-q] [-l] [{-uc | -uco | -uci}]

Parameters

Parameter Description

<ObjectDN>

Required. Specifies the distinguished names of the partition objects to view. If values are omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.

-dn

Displays the distinguished names of the directory partition objects.

-qdefault

Displays the default quota that applies to any security principal (for example, user, group, computer, or iNetOrg person) If no specific quota specification governs that security principal, dsget partition creates an object in the directory partition. An unlimited quota appears as "-1".

-qtmbstnwt

Displays the percent by which the tombstone object count should be reduced when calculating quota usage.

-topobjowner <Display>

Displays a sorted list of the security principals that own the most objects in the specified directory partition This parameter also displays the number of directory objects that those security principals own. Display specifies the number of accounts to display in the list. To display all object owners, use 0 as the value of this parameter. If you do not specify Display, the number of principals that this parameter list defaults to 10.

{-s <Server>| -d <Domain>}

Connects a computer to a remote server or domain that you specify. By default, dsget connects the computer to the domain controller in the logon domain.

-u <UserName>

Specifies the user name with which the user logs on to a remote server. By default, -u uses the user name with which the user logged on. You can use any of the following formats to specify a user name:

  • user name (for example, Linda)

  • domain\user name (for example, widgets\Linda)

  • user principal name (UPN) (for example, Linda@widgets.contoso.com)

-p{ <Password> | *}

Specifies to use either a password or an asterisk (*) to log on to a remote server. If you type *, dsget prompts you for a password.

-c

Reports errors, but continues with the next object in the argument list when you specify multiple target objects (continuous operation mode). If you do not supply this parameter, dsget exits when the first error occurs.

-q

Suppresses all output to standard output (quiet mode).

-l

Displays entries in a list. By default, dsget displays entries in a table.

{-uc| -uco| -uci}

Specifies that dsget formats output or input data in Unicode. The following table lists and describes each format.

Value Description

-uc

Specifies a Unicode format for input from or output to a pipe (|).

-uco

Specifies a Unicode format for output to a pipe (|) or a file.

-uci

Specifies a Unicode format for input from a pipe (|) or a file.

/?

Displays help at the command prompt.

Remarks

  • If you do not supply a target object at the command prompt, dsget obtains the target object from standard input (stdin). Dsget can accept stdin from the keyboard, from a redirected file, or as piped output from another command. To mark the end of stdin data from the keyboard or in a redirected file, use the end-of-file character (CTRL+Z).

  • When none of the optional parameters is specified, the distinguished name of the directory partition object is displayed.

  • If you specify -topobjowner, that parameter overrides any other parameters that you specify. Consequently, dsget displays only the results of -topobjowner.

  • Use dsget to view the properties of a specific object in the directory.

  • As a result of dsquery searches, you can pipe returned objects to dsget and obtain object properties.

  • If a value that you use contains spaces, use quotation marks around the text.

  • If you use multiple values for a parameter, use spaces to separate the values, for example, a list of distinguished names.

Examples

To display all directory partitions in the forest northwindtraders.com that begin with "application", and to display the top three object owners from each partition, type:

dsquery server -forest -part application* | dsget server -part | dsget partition -topjobowner 3