unlink
You must have unlink access to the target workstation.
Syntax
unlink [domain!][folder/]workstation
[;noask]
Arguments
- domain
- Specifies the name of the domain in which to close links. It is not necessary to specify the domain name of a workstation in the master domain. Wildcard characters are permitted. Note: You must always specify the domain name when unlinking a workstation not in the master domain.This argument is useful when unlinking more than one workstation in a domain. For example, to unlink all the agents in domain
stlouis
, use the following command:unlink stlouis!@
If you do not specify domain, and workstation includes wildcard characters, the default domain is the one in which conman is running.
- [folder/]workstation
- Specifies the name of the workstation to be unlinked. Wildcard characters are permitted.
This command is not supported on remote engine workstations.
- noask
- Specifies not to prompt for confirmation before taking action on each qualifying workstation.
Comments
Assuming that a user has unlink access to the workstations being unlinked, the following rules apply:
- A user running conman on the master domain manager can unlink any workstation in the network.
- A user running conman on a domain manager other than the master can unlink any workstation in its own domain and subordinate domains. The user cannot unlink workstations in peer domains.
- A user running conman on an agent can unlink any workstation in its local domain provided that the workstation is either a domain manager or host. A peer agent in the same domain cannot be unlinked.
For additional information see link.
Examples
Unlinked network workstations and Unlinked workstations show the links closed by unlink commands run by users in various locations in the network.
DMn are domain managers and Ann are agents.
Command | Closed by User1 | Closed by User2 | Closed by User3 |
---|---|---|---|
unlink@!@ | All links are closed | DM1-DM2 |
DM2-A21 |
unlink @ | DM1-A11 |
DM1-DM2 |
DM2-A21 |
unlink DOMAIN3!@ | DM3-A31 |
Not allowed | Not allowed |
unlink DOMAIN4!@ | DM4-A41 |
DM4-A41 |
Not allowed |
unlink DM2 | DM1-DM2 | Not applicable | DM2-A21 |
unlink A42 | DM4-A42 | DM4-A42 | Not allowed |
unlink A31 | DM3-A31 | Not allowed | Not allowed |
See also
From the Dynamic Workload Console you can perform the same task as follows:
- In the navigation bar at the top, click .
- Select an engine.
- In Object Type, select Workstation.
- From the Query drop-down list, select a query to monitor workstations.
- Click Run to run the monitoring task.
- From the table containing the list of workstations, select a workstation and click Unlink.