About the -ChangeServer Command

The -ChangeServer command is used to reassign users to another media server.

Each desktop user must back up to a network user data folder that is managed by the same media server to which the user is assigned. If a matching automated user assignment is available on the new media server, the user is automatically assigned a profile and storage location. If a matching automated user assignment is not available, the user can be manually configured.

When a Desktop Agent user is reassigned from one media server to another, the user's current profile settings and existing backup files are not moved. They remain on the original file server.

Use the following syntax:

DLOCommandu -ChangeServer -M <media server> [ -A | -F <file server> | -P <profile name> | -PI <profile id> | -S <SL name> | -SI <SL id> | -SP <SL path> | -U <user> ]

Note:

Wildcard matches (*) are permitted in profile, Storage Location, and user names. Quotation marks are required around names if the name contains a space or colon.

Use the following command options:

Table: -ChangeServer options

Option

Description

-A

Switches all users (default).

-F <file server>

Switches users with storage locations on the named file server.

-M <media server>

The new media server name.

-P <profile name>

Switches users based on profile name.

-PI <profile id>

Switches users based on profile id.

-S <SL name>

Switches users based on storage location name.

-SI <SL id>

Switches users based on storage location id.

-SP <SL path>

Switches users based on storage location path.

-U <user>

Switches users based on user name.

The following examples show you how to use the command options:

DLOCommandu -ChangeServer -M sunshine -P Desktop*

DLOCommandu -ChangeServer -M sunshine -SP \\moonlight\EngDept

DLOCommandu -ChangeServer -M sunshine -SP \\moonlight\EngDept\Enterprise-MNoel