Adds a user to the ban list. Banned users are prevented from logging on to the server during the time specified. To change a ban once it has been added, use /SetBan.
See also /DeleteBan, /SetBan, /GetBan, /ListBans.
Chatcmd Server /AddBan:BannedName=[StartTime][,StopTime][,Reason]
| Server | This switch does not support multiple servers in its command line. |
| BannedName | The BannedName is made up of a nickname, user name, and host name (the user's IP or DNS address), in that order, as follows: |
| [NickName][!UserName][@HostName] | |
| If only the nickname is provided, the server appends the remainder of the ban name format. For example, if /AddBan:monkey=# is entered, the actual ban is monkey!*@*. | |
| Note The asterisk (*) can be used as a wildcard character to match any string. The question mark (?) can be used as a wildcard character to match any character. | |
| StartTime | Start time for the ban, in Universal Coordinate Time (UTC). Use 24-hour format. |
| Note The BannedName can be set to inherit the default values (0:00,0:00,[none]) for StartTime, StopTime, and Reason by setting it equal to the asterisk (*). | |
| StopTime | End time for the ban, in Universal Coordinate Time (UTC). Use 24-hour format. |
| Reason | The reason message can be up to 63 characters. Enclose the reason in quotation marks. |
chatcmd myserv01 /addban:jim=* | |
| Bans any user with nickname Jim. "Jim" is expanded by Chat Service to Jim!*@*. | |
chatcmd myserv01 /addban:*!jjj8025=# | |
| Bans all users in all domains with user ID Jjj8025. "Jjj8025" is expanded by Chat Service to *!Jjj8025@* | |
chatcmd myserv01 /addban:*!*@litware.com=# | |
| Bans all users in the domain litware.com. | |
chatcmd myserv01 /addban:*!jjj8025@litware.com | |
| Bans only user Jjj8025 in the domain litware.com. | |
chatcmd myserv01 /addban:Monkey=08:00,14:00 | |
| The ban name is expanded to Monkey!*@* which bans any user with the nickname Monkey between 8:00 A.M. and 2:00 P.M., UTC. | |
chatcmd myserv01 /addban:jim!*@*=13:00,18:00,"You are being disruptive" | |
| The ban name is Jim!*@*, which bans any username used by anyone with a nickname of Jim from any domain between 1:00 P.M. and 6:00 P.M., UTC, for the stated reason. | |
chatcmd myserv01 /addban:Monkey=# | |
| Bans anyone with the nickname Monkey 24 hours a day. | |
chatcmd myserv01 /addban:litware.com=# | |
| Bans all users from litware.com at all times. |