Windows operating systems

Restore Adobjects

Use the restore adobjects command to restore individual Active Directory objects from the local Deleted Objects container.

Tivoli® Storage Manager clients that run on Windows Server platforms can restore individual Active Directory objects from full system-state backups stored on the Tivoli Storage Manager server.

Supported Clients

This command is valid for Windows Server OS clients.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-Restore ADOBJects--+----------------+--+---------+----------><
                      '-sourcepathspec-'  '-options-'   

Parameters

sourcepathspec
Specifies the Active Directory object or container to restore. If a container is specified, its contents are also restored. You can either specify the full distinguished name of an object or a container, or just the name attribute ('cn' or 'ou'), where the wildcard might be used. The following special characters require an escape character, the backslash, (\), if any of them are contained in the name:
  • \
  • #
  • +
  • =
  • <
  • >

For example, "cn=test#" is entered as "cn=test\#".

Tivoli Storage Manager cannot display any object names that contain an asterisk (*) as part of the name.

Do not use wildcards when you specify a distinguished name.

Table 1. Restore Adobjects command: Related options
Option Where to use
adlocation Command line only.
dateformat (the option is ignored when adlocation is not specified) Client options file (dsm.opt) or command line.
pitdate (the option is ignored when adlocation is not specified) Command line only.
pittime (the option is ignored when adlocation is not specified) Command line only.
replace Client options file (dsm.opt) or command line.
timeformat (the option is ignored when adlocation is not specified) Client options file (dsm.opt) or command line.

Examples

Task
Restore a specific deleted Active Directory object.

Command: restore adobj "CN=Administrator,CN=Users,DC=bryan,DC=test,DC=ibm,DC=com"

Task
Restore all deleted objects that were originally located in the Users container.

Command: restore adobj "CN=Users,DC=bryan,DC=test,DC=ibm,DC=com"

Task
Restore individual Active Directory objects from the Tivoli Storage Manager server. Use the pitdate and pittime options to select from a list of more recent and less recent backup versions (Windows Server 2008 only).
Command: restore adobj "cn=guest" -adloc=server -pitdate=03/17/2008 -pittime=11:11:11
Task
Restore all deleted users with the name starting with Fred.

Command: restore adobjects "cn=Fred*"

Task
Restore all deleted organizational units with the name testou.

Command: restore adobjects "ou=testou"