Home > Commands A-M > Commands Ds-Dz

DSGET


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Displays the selected properties of a specific object in the directory.


Syntax

DSGET {computer | contact | group | ou | partition | quota | server | site | subnet | user} /?

DSGET computer computer_dn ... [-c] [-desc] [-disabled] [-dn] [-l] [-loc] [-p {password | *}] [-part partition_dn [-qlimit] [-qused]] [-q] [{-s server | -d domain}] [-samid] [-sid] [-u user_name] [-uc | -uci | -uco]

DSGET computer computer_dn [-c] [-l] [-memberof [-expand]] [-p {password | *}] [-q] [{-s server | -d domain}] [-u user_name] [-uc | -uci | -uco]

DSGET contact contact_dn ... [-c] [-company] [-dept] [-desc] [-display] [-dn] [-email] [-fax] [-fn] [-hometel] [-iptel] [-l] [-ln] [-mi] [-mobile] [-office] [-p {password | *}] [-pager] [-q] [{-s server | -d domain}] [-tel] [-title] [-u user_name] [-uc | -uci | -uco]

DSGET group group_dn ... [-c] [-desc] [-dn] [-l] [-p {password | *}] [-part partition_dn [-qlimit] [-qused]] [-q] [{-s server | -d domain}] [-samid] [-scope] [-secgrp] [-sid] [-u user_name] [-uc | -uci | -uco]

DSGET group group_dn [-c] [{-memberof | -members}] [-expand]] [-l] [-p {password | *}] [-q] [{-s server | -d domain}] [-u user_name] [-uc | -uci | -uco]

DSGET ou organizational_unit_dn ... [-c] [-desc] [-dn] [-l] [-p {password | *}] [-q] [{-s server | -d domain}] [-u user_name] [-uc | -uci | -uco]

DSGET partition partition_dn ... [-c] [-dn] [-l] [-p {password | *}] [-q] [-qdefault] [-qtmbstnwt] [{-s server | -d domain}] [-topobjowner display] [-u user_name] [-uc | -uci | -uco]

DSGET quota quota_dn ... [-acct] [-c] [-dn] [-l] [-p {password | *}] [-q] [-qlimit] [{-s server | -d domain}] [-u user_name] [-uc | -uci | -uco]

DSGET server server_dn ... [-c] [-desc] [-dn] [-dnsname] [-isgc] [-l] [-p {password | *}] [-part partition_dn | -topobjowner display] [-q] [-site] [{-s server | -d domain}] [-u user_name] [-uc | -uci | -uco]

DSGET site site_cn ... [-autotopology] [-c] [-cachegroups] [-desc] [-dn] [-l] [-p {password | *}] [-prefGCsite] [-q] [{-s server | -d domain}] [-u user_name] [-uc | -uci | -uco]

DSGET subnet subnet_dn ... [-c] [-desc] [-dn] [-l] [-loc] [-p {password | *}] [-q] [{-s server | -d domain}] [-site] [-u user_name] [-uc | -uci | -uco]

DSGET user user_dn ... [-acctexpires] [-canchpwd] [-company] [-dept] [-desc] [-disabled] [-display] [-dn] [-email] [-empid] [-fax] [-fn] [-full] [-hmdir] [-hmdrv] [-hometel] [-iptel] [-ln] [-loscr] [-mgr] [-mi] [-mobile] [-mustchpwd] [-office] [-pager] [-part partition_dn [-qlimit] [-qused]] [-profile] [-pwdneverexpires] [-reversiblepwd] [-samid] [-sid] [-tel] [-title] [-upn] [-webpg] [-uc | -uci | -uco]

DSGET user user_dn [-expand] [-memberof] [-uc | -uci | -uco]


Parameters
computer (NTXP)
Displays the properties of a computer in the directory. There are two variations of this command. The first variation allows you to view the properties of multiple computers. The second variation allows you to view the membership information of a single computer.
computer_dn (NTXP)
First variation, specifies the distinguished names of the computer object list that you want 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.
Second variation, specifies the distinguished name of the single computer you want to view.
contact (NTXP)
Displays the various properties of a contact in the directory.
contact_dn ... (NTXP)
Specifies the distinguished names of the contact objects that you want to view. If omitted, its value is taken from standard input (stdin) to support piping of output from another command to input of this command.
group (NTXP)
Displays the various properties of a group including the members of a group in the directory. There are two variations of this command. The first variation allows you to view the properties of multiple groups. The second variation allows you to view the group membership information of a single group.
group_dn ... (NTXP)
First variation, specifies the distinguished names of the group objects that you want to view. If omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.
Second variation, specifies the distinguished name of the computer you want to view.
ou (NTXP)
Displays the various properties of an organizational unit in the directory.
organizational_unit_dn (NTXP)
Specifies the distinguished names of the organizational units that you want to view. If omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.
partition (NT2003)
Displays the properties of a directory partition.
partition_dn ... (NT2003)
Specifies the distinguished names of the partition objects to view. If omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.
quota (NT2003)
Displays the properties of a quota specification defined in the directory.
quota_dn ... (NT2003)
Specifies the distinguished names of the quota objects to view. If omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.
server (NTXP)
Displays the properties of a domain controller defined in the directory.
server_dn ... (NTXP)
Specifies the list of server object distinguished names to view. If omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.
site (NTXP)
Displays the various properties of a site defined in the directory.
site_cn ... (NTXP)
Specifies the common name of one or more sites that you want 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.
subnet (NTXP)
Displays properties of a subnet defined in the directory.
subnetr_dn ... (NTXP)
Specifies the common names of one or more subnets that you want to view.
user (NTXP)
Display the various properties of a user in the directory. There are two variations of this command. The first variation allows you to view the properties of multiple users. The second variation allows you to view the group membership information of a single user.
user_dn (NTXP)
First variation, specifies the distinguished names of the user objects that you want to view. If omitted, they are obtained through standard input (stdin) to support piping of output from another command to input of this command.
Second variation, specifies the distinguished name of the user you want to view.

Switches
/? (NTXP)
Display help.
-acct (NT2003)
Displays the distinguished names of the accounts to which the quotas are assigned.
-acctexpires (NTXP)
Displays dates indicating when user accounts expire. If the accounts never expire, never is displayed.
-autotopology (NTXP)
Displays information about whether automatic intersite topology generation is enabled (yes) or disabled (no) for specified sites.
-c (NTXP)
Reports errors, but continues with the next object in the argument list when multiple target objects are specified (continuous operation mode). If omitted, the command exits on the first error.
-cachegroups (NTXP)
Displays information about whether caching of universal group memberships for this site is enabled (yes) or disabled (no) to support logons that do not check the global catalog.
-canchpwd (NTXP)
Displays information about whether users can change their password (yes) or not (no).
-company (NTXP)
Displays the company information for the contacts/users.
-d domain (NTXP)
Connects to a specified domain. By default, the computer is connected to the domain controller in the logon domain.
-dept (NTXP)
Displays the departments of the contacts/users.
-desc (NTXP)
Displays the descriptions of the computers/contacts/groups/organizational units/servers/sites/subnets/users.
-disabled (NTXP)
Displays the status of the computer accounts. A value yes returned establishes that the account is disabled (for logon); a value of no establishes that the account is enabled (for logon).
-display (NTXP)
Displays the display names of the contacts/users.
-dn (NTXP)
Displays the distinguished names of the computers/contacts/groups/organizational units/servers/sites/subnets/users.
-dnsname (NTXP)
Displays the DNS host names of the servers.
-email (NTXP)
Displays the e-mail addresses of the contacts/users.
-empid (NTXP)
Displays the employee IDs of the users.
-expand (NTXP)
Displays the recursively expanded list of groups/members of which the computer/group/user is a member. Takes the immediate group membership list of the computer/group/user and then recursively expands each group in this list to determine its group memberships as well to arrive at a complete closure set of the groups.
-fax (NTXP)
Displays the fax numbers of the contacts/users.
-fn (NTXP)
Displays the first names of the contacts/users.
-full (NTXP)
Displays the full names of the users.
-hmdir (NTXP)
Displays the home directory the user is mapped to, may be an UNC path.
-hmdrv (NTXP)
Displays the user's home drive letter if home directory is a UNC path.
-hometel (NTXP)
Displays the home telephone numbers of the contacts/users.
-iptel (NTXP)
Displays the IP phone numbers of the contacts/users.
-isgc (NTXP)
Displays information about whether the server is a global catalog (yes) or not (no).
-l (NTXP)
Displays entries in a list format. By default, entries are displayed in a table format.
-ln (NTXP)
Displays the last names of the contacts/users.
-loc (NTXP)
Displays the computer/subnet locations.
-loscr (NTXP)
Displays the user logon script paths.
-memberof (NTXP)
Displays the immediate list of groups of which the computer/group/user is a member. This takes a single target object only as input.
-members (NTXP)
Displays the immediate list of members of the group.
-mgr (NTXP)
Displays the user managers of the users.
-mi (NTXP)
Displays the middle initial of the contacts/users.
-mobile (NTXP)
Displays the mobile phone numbers of the contacts/users.
-mustchpwd (NTXP)
Displays information about whether users must change their passwords at the time of next logon (yes) or not (no).
-office (NTXP)
Displays the office locations of the contacts/users.
-p {password | *} (NTXP)
Specifies to use either a password or * to log on to a remote server. If *, then prompted for password.
-pager (NTXP)
Displays the pager numbers of the contacts/users.
-part partition_dn (NT2003)
Specifies the distinguished name of the directory partition on which you want to create a quota. If you do not specify the partition_dn it is taken from standard input (stdin).
-prefGCsite (NTXP)
Displays the name of the preferred global catalog site used to refresh universal group membership caching for this site?s domain controllers, if universal group membership caching has been enabled.
-profile (NTXP)
Displays the user profile paths.
-pwdneverexpires (NTXP)
Displays information about whether the user passwords never expires (yes) or not (no).
-q (NTXP)
Suppresses all output to standard output (quiet mode).
-qdefault (NT2003)
Displays the default quota that applies to any security principal (user, group, computer, or iNetOrg person) creating an object in the directory partition, if no specific quota specification governs that security principal. An unlimited quota displays as "-1".
-qlimit (NT2003)
Displays the effective quota of the computer within the specified directory partition.
-qtmbstnwt (NT2003)
Displays the percent by which the tombstone object count should be reduced when calculating quota usage.
-qused (NT2003)
Displays how much of its quota the computer has used within the specified directory partition.
-reversiblepwd (NTXP)
Displays information about whether the user passwords are allowed to be stored using reversible encryption (yes) or not (no).
-s server (NTXP)
Connects to a specified remote server. By default, the computer is connected to the domain controller in the logon domain.
-samid (NTXP)
Displays the computer/group/users SAM account names.
-scope (NTXP)
Display information about whether group scopes are local, global, or universal.
-secgrp (NTXP)
Displays information about whether groups are security groups (yes) or a distribution groups (no).
-sid (NTXP)
Displays the computer/group/users security IDs (SIDs).
-site (NTXP)
Displays the site names to which the servers/subnets belong.
-tel (NTXP)
Displays the telephone numbers of the contacts/users.
-title (NTXP)
Displays the titles of the contacts/users.
-topobjowner display (NT2003)
Displays a sorted list of the security principals (users, computers, security groups, and inetOrgPersons) that own the largest number of directory objects across all directory partitions on the server and the number of directory objects that they own. The number of accounts to display in the list is specified by display (0 - all, 10 - default).
Overrides any other specified switches, so that only the results of -topobjowner are displayed.
-u user_name (NTXP)
Specifies the user name with which user will log on to a remote server. By default, the logged on user name is used. You can specify a user name using one of the formats:
      user name
      domain\user name
      user principal name (UPN)
-uc | -uci | -uco (NT2003)
Specifies that output or input data is formatted in Unicode:
-upn (NTXP)
Displays the user principal names of the users.
-wegpg (NTXP)
Displays the user Web page URLs.

Related

none.


Notes

none.


Examples

none.


Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NTXP NT2003