The Netsh commands for Windows Internet Name Service (WINS) offer a command-line tool for administering WINS servers that can be used as an equivalent alternative to console-based management. This is useful in the following situations:
- When managing WINS servers in wide area
networks (WANs), commands can be used in interactive mode at the
Netsh command prompt to better manage slow-speed network links.
- When managing a large number of WINS servers,
commands can be used in batch mode to script and automate recurring
administrative tasks that need to be performed for all WINS
servers.
You can run these commands from the Windows Server 2008 command prompt or from the command prompt for the Netsh wins context. For these commands to work at the Windows Server 2008 command prompt, you must type netsh wins before typing commands and parameters as they appear in the syntax below.
Notes
- Unless otherwise specified, field tags (such
as Name= and EndChar=) are optional. If tags are
used, they must be applied to all of the parameters in the command.
If tags are omitted, a value must be provided for each of the
fields that are supported in this command.
- The terms Persona Non Grata (PNG) and Persona
Grata (PG) refer to the features Block records for these
owners and Accept records only for these owners,
respectively.
- For more information about Netsh, see
Netsh
Overviewand Enter a Netsh
Context.
- For an example of how to use Netsh commands
for WINS in batch files and scripts, see Netsh WINS
Example.
The following commands are available at the wins> prompt, which is rooted within the netsh environment.
To view the command syntax, click a command:
- server
- add
- add name
- add partner
- add pgserver
- add pngserver
- check
- check database
- check name
- check version
- delete
- delete name
- delete owners
- delete partner
- delete pgserver
- delete pngserver
- delete records
- init
- init backup
- init import
- init pull
- init pullrange
- init push
- init replicate
- init restore
- init scavenge
- init search
- reset
- reset statistics
- set
- set
autopartnerconfig
- set backuppath
- set burstparam
- set defaultparam
- set logparam
- set migrateflag
- set namerecord
- set
periodicdbchecking
- set pgmode
- set pullparam
- set
pullpartnerconfig
- set pushparam
- set
pushpartnerconfig
- set replicateflag
- set startversion
- show
- show browser
- show database
- show info
- show name
- show partner
- show
partnerproperties
- show
pullpartnerconfig
- show
pushpartnerconfig
- show recbyversion
- show reccount
- show server
- show
serverstatistics
- show version
- show versionmap
For information on how to interpret netsh command syntax, see Formatting Legend.
Netsh WINS commands
The following entries provide details for each command.
server
Switches to the specified server context. Used without parameters, the local WINS server is assumed as the default.
Syntax
server [{\\ServerName | IPAddress}]
Parameters
- { \\ServerName| IPAddress}
- Specifies the remote (non-local) WINS server to which to switch the Netsh WINS command-line context. Identifies the server by server name or IP address.
Examples
In the first example, this command changes the Netsh context to the local WINS server.
In the second example, this command changes the Netsh context to a remote server named \\WINS-SRV1.
In the third example, this command changes the Netsh context to a remote server with IP address 10.0.0.1.
server
server \\WINS-SRV1
server 10.0.0.1
Netsh WINS server
The following commands are available at the wins server> prompt, which is rooted within the netsh environment.
To view the command syntax, click a command:
add
add name
Adds a name record to the database on the specified WINS server.
Syntax
add name [Name=]ComputerName [[EndChar=]16thCharInHex] [[Scope=]ScopeName] [[RecType=]{0 | 1}] [[Group=]{0 | 1 | 2 | 3 | 4}] [[Node=]{0 | 1 | 3}] [IP=]{IPAddress1[,IPAddress2,IPAddress3... ]}
Parameters
- [ Name=] ComputerName
- Required. Specifies the name to add and register in the WINS server database.
- [ EndChar=] 16thCharInHex
- Indicates the 16th character of the name in hexadecimal. If unspecified, record types are added based on the value of Group=. For more information, see Remarks.
- [ Scope=] ScopeName
- Specifies the name of the NetBIOS scope.
- [ RecType=]{ 0| 1}
- Indicates the record type: 0-Static (default), 1-Dynamic.
- [ Group=]{ 0| 1| 2| 3| 4}
- Indicates the group type: 0-Unique (default), 1-Group, 2-Internet 3-Multihomed, 4-Domain Name.
- [ Node=]{ 0| 1| 3}
- Indicates the NetBIOS node type: 0-B Node, 1-P Node (default), 3-H Node.
- [ IP=] {IPAddress1[ ,IPAddress2,IPAddress3...] }
- Required. Specifies the IP address of the name record to add. If the computer is multihomed, more than one IP address can be specified. Use braces ({}) to enclose one or more IP addresses, and separate multiple IP addresses with commas.
Remarks
- If EndChar= and Group= are both
used, EndChar= overrides Group=.
- When EndChar= is not specified, the
following record types are added to the WINS database based on the
value of Group=:
Group parameter value Record type added Unique group (0)
03h, 20h, 00h
Normal group (1)
1eh
Special group/Internet (2)
20h
Multihomed group (3)
03h, 20h, 00h
Special group/domain (4)
1ch
Examples
In the first example, this command adds a default NetBIOS record set of the 00h, 03h, and 20h records for a computer named HOSTA with a mapped IP address of 10.0.0.1.
In the second example, this command adds a 20h record for HOSTB, a multihomed computer with IP addresses 10.0.0.2 and 10.0.0.3, on SUBNETA, with a static record type and P-Node configuration.
add name Name=HOSTA IP={10.0.0.1}
add name HOSTB 20 SUBNETA 0 3 1{10.0.0.2,10.0.0.3}
add partner
Adds a replication partner to the list of replication partners on the specified WINS server.
Syntax
add partner [Server=]IPAddress [[NetBIOS=]ServerNetBIOSName] [[Type=]{0 | 1 | 2}]
Parameters
- [ Server=] IPAddress
- Required. Specifies the replication partner to add to the WINS server. Identifies the partner server by IP address.
- [ NetBIOS=] ServerNetBIOSName
- Specifies the replication partner to add to the WINS server. Identifies the partner server by NetBIOS name.
- [ Type=]{ 0| 1| 2}
- Indicates the type of partner to add: 0-Pull, 1-Push, 2-Both (default).
Remarks
- If the IP address does not resolve, the
NetBIOS name parameter is used to create the partner record.
Otherwise, the NetBIOS parameter is not used.
Examples
In the following example, this command adds a push/pull replication partner with an IP address of 10.2.2.2 to the current WINS server.
add partner 10.2.2.2
add pgserver
Adds a list of Persona Grata (PG) servers to the specified WINS server.
Syntax
add pgserver [Servers=]{ListOfServerIPAddresses}
Parameters
- [ Servers=] {ListOfServerIPAddresses}
- Required. Specifies the Persona Grata server or servers to add. Identifies each server by its IP address, enclosed by braces ({}). If you provide a list, IP addresses must be separated by commas and enclosed by braces ({}).
Remarks
- This command adds the new server or servers
after checking for duplicates. The PG list is used to specify
owners (other WINS servers) whose records are to be accepted during
replication.
Examples
In the following example, this command adds the WINS servers 10.2.2.2 and 10.2.2.3 to the Persona Grata list for the current WINS server.
add pgserver {10.2.2.2,10.2.2.3}
add pngserver
Adds a list of Persona Non Grata (PNG) servers to the specified WINS server.
Syntax
add pngserver [Servers=]{ListOfServerIPAddresses}
Parameters
- [ Servers=] {ListOfServerIPAddresses}
- Required. Specifies the Persona Non Grata server or servers to add. Identifies each server by its IP address, enclosed by braces ({}). If you provide a list, IP addresses must be separated by commas and enclosed by braces ({}).
Remarks
- This command adds the new server or servers
after checking for duplicates. The PNG list is used to specify
owners (other WINS servers) whose records are to be blocked during
replication.
Examples
In the following example, this command adds the WINS servers 10.2.2.2 and 10.2.2.3 to the PNG list for the current WINS server.
add pngserver {10.2.2.2,10.2.2.3}
check
check database
Checks the consistency of the WINS database. Used without parameters, a consistency check is performed on all replicas whose verification interval has expired. The consistency check is not performed immediately if overload conditions exist, but occurs after the configured verification interval period has passed.
Syntax
check database [[All=]{1 | 0}] [[Force=]{1 | 0}]
Parameters
- [ All=]{ 1| 0}
- Indicates whether to perform a consistency check on all replicas or to perform a consistency check on the replicas whose verification interval has expired: 1-All, 0-Otherwise (default).
- [ Force=]{ 1| 0}
- Indicates whether to override the WINS consistency check under overload conditions: 1-Override, 0-Otherwise (default).
Remarks
- It is a network and resource intensive
operation to check all replicas for consistency.
- Overload condition occurs when the
consistency check command is repeated within the duration of one
hour.
Examples
In the following example, this command does a consistency check for all replicas. If overload conditions exist, the consistency check is performed after the configured verification interval has passed.
check database 1
check name
Checks a list of name records against a specified set of WINS servers.
Syntax
check name {NameFile=FileName | NameList={NamesList}} {ServerFile=FileName | ServerList={ListOfServerIPAddresses}}[InclPartner={Y | y}]
Parameters
- { NameFile=FileName| NameList={NamesList}}
- Required. Specifies the file that contains the list of names to check or specifies a list of names to check. If you provide a list, names must be separated by commas and enclosed by braces ({}).
- { ServerFile=FileName| ServerList={ListOfServerIPAddresses}}
- Required. Specifies the file with the list of server IP addresses or specifies a list of the server IP addresses to check. If you provide a list, IP addresses must be separated by commas and enclosed by braces ({}).
- InclPartner={ Y| y}
- Specifies that all partners will be included in the list of servers. Partners are not included by default.
Remarks
- Tags are required for this command. Whenever
inconsistencies are found, repair is attempted.
- The format for Name in both
NameFile and NameList is Name*16thchar, where
Name is the record name and 16thchar is the 16th character
for the record.
- In the file, name entries are separated by
commas or carriage returns/line feeds.
Examples
In the first example, this command checks WINS data against the Names.txt and Servers.txt files, assuming those files to be located in the specified path location (the root of drive D).
In the second example, this command checks the names Name1 with 16th character 03, 00 and 20h respectively against the servers with IP addresses 10.2.2.2 and 10.2.2.3.
check name NameFile=D:\Names.txt ServerFile=D:\Servers.txt
check name NameList={Name1*03,Name1*00,Name1*20} ServerList={10.2.2.2,10.2.2.3}
check version
Checks the consistency of version ID numbers for WINS record owners in the WINS database.
Syntax
check version [Server=]IPAddress [[File=]FileName]
Parameters
- [ Server=] IPAddress
- Required. Specifies the IP address of the start WINS server.
- [ File=] FileName
- Specifies the file in which to store the index to IP address table. If omitted, check version creates the file Wins.rec in the current directory and stores the index to IP address table there.
Remarks
- If you provide a file name that is not valid,
FileName is set to Wins.rec in the current directory.
- You might need to increase the width of the
command window to make it wide enough to view the table
correctly.
Examples
In the following example, this command verifies the version number consistency of the records for a WINS server with the IP address 10.2.2.2 at its replication partners.
check version 10.2.2.2
delete
delete name
Deletes a registered name from the WINS server database.
Syntax
delete name [Name=]RegisteredName [EndChar=]16thCharInHex [[Scope=]ScopeName]
Parameters
- [ Name=] RegisteredName
- Required. Specifies the registered name to be deleted.
- [ EndChar=] 16thCharInHex
- Required. Indicates the 16th character of the name of the record to be deleted in hexadecimal.
- [ Scope=] ScopeName
- Specifies the NetBIOS scope identifier for the record to be deleted.
Examples
In the following example, this command deletes the messenger (03h) records with the record name HOSTA from the WINS database.
delete name Name=HOSTA EndChar=03
delete owners
Deletes or tombstones a list of owners and their records from the database on the specified WINS server.
Syntax
delete owners [Servers=]{ListOfServerIPAddresses}[[Op=]{0 | 1}]
Parameters
- [ Servers=] {ListOfServerIPAddresses}
- Required. Specifies a list of the owner servers with records to delete. Identifies the servers by IP addresses that must be separated by commas and enclosed by braces ({}).
- [ Op=]{ 0| 1}
- Indicates your option: 0-Tombstone (default), 1-Delete.
Examples
In the following example, this command deletes all records owned by the WINS server with the IP address 10.0.0.1.
delete owners Servers={10.0.0.1} Op=1
delete partner
Deletes either all replication partners or a specified replication partner from the list of replication partners on the specified WINS server. When used without parameters, all replication partners are deleted from both the pull and the push partner lists without a confirmation prompt.
Syntax
delete partner [[Server=]IPAddress] [[Type=]{0 | 1 | 2}] [[Confirm=]{Y | y}]
Parameters
- [ Server=] IPAddress
- Specifies the partner to delete. Identifies the partner by IP address.
- [ Type=]{ 0| 1| 2}
- Indicates the type of partner list to delete: 0-Pull, 1-Push, 2-Both (default).
- [ Confirm=]{ Y| y}
- Initiates and completes the operation without prompting for confirmation.
Examples
In the following example, this command deletes a push/pull type partner with an IP address of 10.0.0.1 from the current WINS server without prompting for confirmation.
delete partner Server=10.0.0.1 Type=2 Confirm=Y
delete pgserver
Deletes all or specific Persona Grata servers from the list of PG servers on the specified WINS server.
Syntax
delete pgserver [Servers=]{ListOfServerIPAddresses}
Parameters
- [ Servers=] {ListOfServerIPAddresses}
- Required. Specifies a list of Persona Grata servers to delete. Identifies PG servers by IP addresses separated by commas and enclosed by braces ({}).
Remarks
- The Persona Grata (PG) list specifies owners
(other WINS servers) whose records are to be accepted during
replication. If you use an empty set of braces ({}), delete
pgserver deletes all of the servers on the PG server list.
Examples
In the following example, this command deletes the WINS servers 10.2.2.2 and 10.2.2.3 from the Persona Grata list for this WINS server.
delete pgserver Servers={10.2.2.2,10.2.2.3}
delete pngserver
Deletes all or specific Persona Non Grata servers servers from the list of PNG servers on the specified WINS server.
Syntax
delete pngserver [Servers=]{ListOfServerIPAddresses}
Parameters
- [ Servers=] {ListOfServerIPAddresses}
- Required. Specifies a list of Persona Non Grata servers to delete. Identifies PNG servers by IP addresses separated by commas and enclosed by braces ({}).
Remarks
- The Persona Non Grata (PNG) list specifies
owners (other WINS servers) whose records are to be blocked during
replication. If you use an empty set of braces ({}), delete
pngserver deletes all of the servers on the PNG server
list.
Examples
In the following example, this command deletes the WINS servers 10.2.2.2 and 10.2.2.3 from the Persona Non Grata list for this WINS server.
delete pngserver Servers={10.2.2.2,10.2.2.3}
delete records
Deletes all records or a set of records from the current WINS server or marks records as tombstoned.
Syntax
delete records [MinVer=]{High,Low} [MaxVer=]{High,Low} [[Op=]{0 | 1}]
Parameters
- [ MinVer=] {High,Low}
- Required. Specifies the minimum high and low record versions from which to begin deletion. High and low values are separated by a comma and enclosed by braces ({}).
- [ MaxVer=] {High,Low}
- Required. Specifies the maximum high and low record versions at which to end deletion. High and low values are separated by a comma and enclosed by braces ({}).
- [ Op=]{ 0| 1}
- Indicates your option: 0-Delete (default), 1-Tombstone.
Remarks
- If you set both MinVer= and
MaxVer= to {0,0}, delete records deletes all
records.
Examples
In the first example, this command marks all records on the WINS server as tombstoned.
In the second example, this command deletes all records between and including 2de2d and 2de3f.
delete records MinVer={0,0} MaxVer={0,0} Op=1
delete records MinVer={0,2de2d} MaxVer={0,2de3f}
init
init backup
Initiates backup of the WINS database to a specified directory. Used without parameters, this command provides a full backup to the default backup path that is currently set.
Syntax
init backup [[Dir=]BackupDir] [[Type=]{0 | 1}]
Parameters
- [ Dir=] BackupDir
- Specifies the directory in which backups are stored. If unspecified, the default backup path that is currently set is used.
- [ Type=]{ 0| 1}
- Indicates the type of backup: 0-Full backup (default), 1-Incremental backup.
Remarks
- WINS backup can only be used for a local
backup on the same server. Backup of remote WINS servers is not
supported.
- Backup files will automatically be created
under the wins_bak subdirectory of the Dir= directory.
Examples
In the following example, this command initiates a full backup of the WINS database on the local WINS server to the folder C:\WINSfiles\wins_bak. WINS will create the wins_bak subdirectory.
init backup Dir=C:\WINSfiles Type=0
init import
Initiates the import of static mappings from an Lmhosts file.
Syntax
init import [File=]ImportFile
Parameters
- [ File=] ImportFile
- Required. Specifies the Lmhosts-formatted text file used for importing static mappings into the WINS database.
Examples
In the following example, this command imports the static mappings of the Fixedip.sam file, located at the C:\WINSfiles path, as new static mappings in the local WINS database.
init import File=C:\WINSfiles\Fixedip.sam
init pull
Initiates and sends a pull trigger to another WINS server.
Syntax
init pull [Server=]{PullServerName | IPAddress}
Parameters
- [ Server=]{ \\PullServerName| IPAddress}
- Required. Specifies the WINS server to which to send a pull trigger. Identifies the server by server name or IP address.
Remarks
- If you provide a server name that cannot be
resolved to an IP address, the operation fails.
Examples
In the following example, this command initiates and sends a pull trigger to WINS server 10.2.2.2.
init pull Server=10.2.2.2
init pullrange
Initiates and pulls a range of records from another WINS server.
Syntax
init pullrange [Owner=]OwnerServerIP [Server=]PullServerIP [MaxVer=]{High,Low} [MinVer=]{High,Low}
Parameters
- [ Owner=] OwnerServerIP
- Required. Specifies the WINS server with records to be pulled. Identifies the server by IP address.
- [ Server=] PullServerIP
- Required. Specifies the WINS server that pulls the range of records. Identifies the server by IP address.
- [ MaxVer=] {High,Low}
- Required. Specifies the maximum high and low version number of the records to be pulled. High and low values are separated by a comma and enclosed by braces ({}).
- [ MinVer=] {High,Low}
- Required. Specifies the minimum high and low version number of the records to be pulled. High and low values are separated by a comma and enclosed by braces ({}).
Remarks
- If you set both MaxVer= and
MinVer= to {0,0}, init pullrange pulls the entire
range of records.
Examples
In the following example, this command initiates and sends a pull trigger to WINS server 10.2.2.3 for all records owned by WINS server 10.2.2.2.
init pullrange Owner=10.2.2.2 Server=10.2.2.3 MaxVer={0,0} MinVer={0,0}
init push
Initiates and sends a push trigger to another WINS server.
Syntax
init push [Server=]{\\PushServerName | IPAddress} [[PropReq=]{0 | 1}]
Parameters
- [ Server=]{ \\PushServerName| IPAddress}
- Required. Specifies the WINS server to which to send a push trigger. Identifies the server by name or IP address.
- [ PropReq=]{ 0| 1}
- Indicates your propagation request: 0-Push to the specified server only (default), 1-Have server propagate the push trigger to all of its partners.
Remarks
- If you provide a server name that cannot be
resolved to an IP address, the operation fails.
Examples
In the following example, this command initiates and sends a push trigger to WINS server 10.2.2.2 and has it propagate the trigger to all of its replication partners.
init push Server=10.2.2.2 PropReq=1
init replicate
Initiates and forces an immediate replication of the database with replication partners.
Syntax
init replicate
Parameters
none
Remarks
- This command initiates the push/pull
replication with all replication partners for this server.
init restore
Initiates the restoration of the WINS database from a directory and file at the specified WINS server.
Syntax
init restore [Dir=]RestoreDir
Parameters
- [ Dir=] RestoreDir
- Required. Specifies the directory from which to restore files.
Remarks
- WINS backups can only be restored locally on
the same server. You cannot restore the WINS database from a remote
computer.
- Dir= should contain a subdirectory
wins_bak, which will contain the database file, but this
subdirectory should not be included in the Dir=
parameter.
Examples
In the following example, this command restores the WINS database from the backup database file location of C:\WINSfiles.
init restore Dir=C:\WINSfiles
init scavenge
Initiates the scavenging of the WINS database for the specified WINS server.
Syntax
init scavenge
Parameters
none
Remarks
- This command removes outdated information
from the WINS database.
init search
Initiates a search for the specified record name in the WINS database.
Syntax
init search [Name=]RecordName [[EndChar=]EndCharacter] [[Case=]{0 | 1}] [[File=]FileName]
Parameters
- [ Name=] RecordName
- Required. Specifies the name of the record for which to search.
- [ EndChar=] EndCharacter
- Indicates the 16th character of the NetBIOS name record. If unspecified, the search returns all records that match the string that you entered as a value for Name=. For more information, see Remarks.
- [ Case=]{ 0| 1}
- Indicates name case preference: 0-Ignore name case (default), 1-Use name case.
- [ File=] FileName
- Specifies the file in which to store ASCII plain text output. If unspecified, output is displayed in the Command Prompt window.
Remarks
- If you do not supply a value for
EndChar=, the search returns all records that match the
string that is entered as a value for Name=. For example, if
the database contains a record named MYPC-1, a search that uses
MYPC as the value of the name parameter returns all records
starting with this name pattern, regardless of record type:
Record Name Record Type MYPC-1
[00h]Workstation
MYPC-1
[01h]Other
MYPC-1
[03h]Messenger
Record Name Record Type MYPC-1
[00h]Workstation
Examples
In the following example, this command searches for records named dc1 with an end character of 1c, ignores name case, and outputs the information to the names.txt file located in C:\WINSfiles.
init search Name=dc1 EndChar=1c Case=0 File=C:\WINSfiles \names.txt
reset
reset statistics
Resets the statistics for the local WINS server.
Syntax
reset statistics
Parameters
none
set
set autopartnerconfig
Sets the automatic replication partner configuration information for the server. Used without parameters, automatic partner configuration is reset (disabled).
Syntax
set autopartnerconfig [[State=]{0 | 1}] [[Interval=]Value] [[TTL=]Value]
Parameters
- [ State=]{ 0| 1}
- Indicates the automatic replication partner configuration information setting: 0-Reset (default), 1-Set.
- [ Interval=] Value
- Specifies the multicast interval value, in seconds.
- [ TTL=] Value
- Specifies the Time-To-Live (TTL) value for multicast datagrams between partner WINS servers. The TTL value must be within the range of 1 to 32.
Examples
In the following example, this command sets the automatic configuration information for this WINS server for a multicast interval of 3,600 seconds and a TTL value of 20.
set autopartnerconfig State=0 Interval=3600 TTL=20
set backuppath
Sets the backup parameters for the specified WINS server.
Syntax
set backuppath [Dir=]NewPath [[Shutdown=]{0 | 1}]
Parameters
- [ Dir=] NewPath
- Required. Specifies the backup path for the server database. If unspecified, the default path is C:\.
- [ Shutdown=]{ 0| 1}
- Indicates the setting for backup during shutdown: 0-Disable backup of the WINS database during shutdown (default), 1-Enable backup of the WINS database during shutdown.
Examples
In the following example, this command sets the WINS server to automatically back up the WINS database to C:\WINSfiles each time that the server is shut down.
set backuppath Dir=C:\WINSfiles Shutdown=1
set burstparam
Sets burst handling parameters for the specified WINS server.
Syntax
set burstparam [State=]{0 | 1} [[Value=]QueueSize]
Parameters
- [ State=]{ 0| 1}
- Required. Indicates the setting for burst handling: 0-Reset or disable burst handling for the WINS server, 1-Set or enable burst handling for the WINS server.
- [ Value=] QueueSize
- Specifies the value of the burst queue size. The queue size must be within the range of 50 to 5,000.
Examples
In the following example, this command sets the size of the burst queue to permit 1,000 client registration and renewal requests before the WINS server uses burst handling.
set burstparam State=1 Value=1000
set defaultparam
Sets the default parameters for WINS server configuration.
Syntax
set defaultparam
Parameters
none
Remarks
- This command sets all the configuration
parameters for the WINS server to their default values. It is
recommended that you run this command after WINS service
installation to configure the server with default parameter
settings.
set logparam
Sets or resets database and detailed event logging parameters. Used without parameters, the current values are maintained.
Syntax
set logparam [[DBChange=]{0 | 1}] [[Event=]{0 | 1}]
Parameters
- [ DBChange=]{ 0| 1}
- Indicates whether you want to log database changes: 1-Enable logging of database changes to JET log files (default), 0-Reset this option.
- [ Event=]{ 0| 1}
- Indicates the detail of events: 1-Log detailed events to the system event log, 0-Reset this option (default).
Remarks
- The WINS database engine can log the database
changes to separate files. Because this option improves the
performance of database operations, it is turned on by default.
- The WINS server can log detailed event
information in the system event log. Because this option is
resource-intensive, it is turned off by default.
Examples
In the following example, this command sets logging parameters for this WINS server to enable the logging of database changes to JET files and to log detailed events to the system event log.
set logparam Event=1
set migrateflag
Sets the migration flag for the specified WINS server.
Syntax
set migrateflag [State=]{0 | 1}
Parameters
- [ State=]{ 0| 1}
- Required. Indicates the setting of the migrate flag: 0-Disable (migrate off), 1-Enable (migrate on)
Remarks
- The migrate flag determines if unique static
mappings can be overwritten by dynamic records.
Examples
In the following example, this command sets the migrate flag to permit the overwriting of unique static mappings by dynamic records for the specified WINS server.
set migrateflag State=1
set namerecord
Sets the intervals that are used to determine when WINS name records are renewed, deleted, and verified at the specified WINS server. Used without parameters, current values are maintained.
Syntax
set namerecord [[Renew=]Value] [[Extinction=]Value] [[ExTimeout=]Value] [[Verification=]Value]
Parameters
- [ Renew=] Value
- Specifies the interval renewal rate, in seconds.
- [ Extinction=] Value
- Specifies the extinction interval, in seconds.
- [ ExTimeout=] Value
- Specifies the extinction time-out, in seconds.
- [ Verification=] Value
- Specifies the verification interval, in seconds.
Remarks
- All parameters are optional. For parameters
not used, previously set or default values are maintained.
Examples
In the following example, this command sets each of the values for name records on this WINS server.
set namerecord Renew=3600 Extinction=7200 ExTimeout=86400 Verification=2073600
set periodicdbchecking
Sets the periodic database consistency checking parameters for the specified WINS server. Used without parameters, current values are maintained.
Syntax
set periodicdbchecking [[State=]{0 | 1}] [[MaxRec=]Value] [[CheckAgainst=]{0 | 1}] [[CheckEvery=]Value] [[Start=]Value]
Parameters
- [ State=]{ 0| 1}
- Required. Indicates whether to check the state of the WINS database: 0-Disable, 1-Enable (default). If you set the value of this parameter to 0, all checks are disabled regardless of the values of other parameters.
- [ MaxRec=] Value
- Specifies the maximum number of records that are checked each period. If unspecified, the default is 30,000.
- [ CheckAgainst=]{ 0| 1}
- Indicates the server to check against: 0-Owner server (default), 1-Randomly selected server.
- [ CheckEvery=] Value
- Specifies how often the WINS database should be checked for consistency, in hours. If unspecified, the default is 24 hours.
- [ Start=] Value
- Specifies the time, in seconds, at which to start the consistency check.
Remarks
- In order to set periodic consistency check
intervals, it is recommended that you specify values for the
CheckEvery and Start parameters. In order to adjust
existing periodic consistency check settings, specify values only
for State and the parameter or parameters that you want to
change. Parameters for which you do not supply a value remain
unchanged.
Examples
In the following example, this command checks the WINS database against a random replication partner every hour starting at 3,600 seconds.
set periodicdbchecking State=1 MaxRec=1000 CheckAgainst=1 CheckEvery=1 Start=3600
set pgmode
Sets the Persona Grata mode or the Persona Non Grata mode.
Syntax
set pgmode [Mode=]{0 | 1}
Parameters
- [ Mode=]{ 0| 1}
- Required. Specifies which mode to set: 0-Sets the Persona Non Grata (PNG) mode, 1-Sets the Persona Grata (PG) mode.
Remarks
- Use the add pgserver and the delete
pgserver commands to update the Persona Grata list.
Examples
In the following example, this command sets the PG mode. During replication, WINS will accept only the records that are owned by the servers that are specified in the PG list.
set pgmode Mode=1
set pullparam
Sets the default pull partner parameters for the specified WINS server. Used without parameters, previously set or default values are maintained.
Syntax
set pullparam [[State=]{0 | 1}] [[Strtup=]{0 | 1}] [[Start=]Value] [[Interval=]Value] [[Retry=]Value]
Parameters
- [ State=]{ 0| 1}
- Required. Indicates whether you want persistent connections to be used with pull partners: 0-Do not use persistent connections with pull partners, 1-Use persistent connections with pull partners.
- [ Strtup=]{ 0| 1}
- Indicates whether pull replication should start at startup: 0-Do not start pull replication at startup (default), 1-Start pull replication at startup.
- [ Start=] Value
- Specifies the start time for the pull trigger, in seconds.
- [ Interval=] Value
- Specifies the replication interval, in seconds.
- [ Retry=] Value
- Specifies the number of times to retry replication.
Remarks
- If you do not specify a value for
Interval=, only one replication occurs.
- If you do not specify a value for
Start=, running the command starts the pull trigger.
Examples
In the following example, this command sets the default pull partner parameters for this WINS server to use a persistent connection with its pull partners, begin replication at startup, start the pull trigger in 23,600 seconds at an interval of 259,200 seconds, and retry replication seven times.
set pullparam State=1 Strtup=1 Start=23600 Interval=259200 Retry=7
set pullpartnerconfig
Sets the configuration parameters for the specified pull partner.
Syntax
set pullpartnerconfig [[State=]{0 | 1}] [Server=]ServerName [[Start=]Value] [[Interval=]Value]
Parameters
- [ State=]{ 0| 1}
- Indicates the state of the persistent connection flag: 0-Disable, 1-Enable (default).
- [ Server=] ServerName
- Required. Specifies the pull replication partner by server name or IP address.
- [ Start=] Value
- Specifies the start time for replication, in seconds.
- [ Interval=] Value
- Specifies the interval between pull replications, in seconds.
Remarks
- If you provide a server name for
Server= that cannot be resolved to an IP address, the
function fails.
Examples
In the following example, this command sets the pull partner configuration for the current WINS server for the partner WINS server 10.2.2.2. Pull replication starts in 3,600 seconds and runs every 4,320 seconds.
set pullpartnerconfig State=1 Server=10.2.2.2 Start=3600 Interval=4320
set pushparam
Sets the default push partner parameters for the specified WINS server.
Syntax
set pushparam [State=]{0 | 1} [[Strtup=]{0 | 1}] [[AddChange=]{0 | 1}] [[Update=]Value]
Parameters
- [ State=]{ 0| 1}
- Required. Indicates whether you want persistent connections to be used with push partners: 0-Do not use persistent connections with push partners, 1-Use persistent connections with push partners.
- [ Strtup=]{ 0| 1}
- Indicates whether you want push replication to start at startup: 0-Do not start push replication at startup (default), 1-Start push replication at startup.
- [ AddChange=]{ 0| 1}
- Indicates whether you want replication to be triggered upon address change: 0-Do not trigger replication upon address change (default), 1-Trigger replication upon address change.
- [ Update=] Value
- Specifies the number of changes in version ID that will occur before replication.
Examples
In the following example, this command sets the default push partner parameters for this WINS server to use persistent connections with its push partners, start push replication at startup and when addresses change, and push to partners after the version ID has been updated twice for records owned at this WINS server.
set pushparam State=1 Strtup=1 AddChange=1 Update=2
set pushpartnerconfig
Sets the configuration parameters for the specified push partner.
Syntax
set pushpartnerconfig [[State=]{0 | 1}] [Server=]\\ServerName [Update=]Value
Parameters
- [ State=]{ 0| 1}
- Indicates the state of the persistent connection flag: 0-Disable, 1-Enable (default).
- [ Server=] \\ServerName
- Required. Specifies the push partner server for which you want to set configuration parameters. Identifies the server by server name or IP address.
- [ Update=] Value
- Required. Specifies the threshold for updates.
Remarks
- If you provide a name in the server parameter
cannot be resolved to an IP address, the function fails.
Examples
In the following example, this command sets the push partner configuration for the current WINS server for a partner WINS server with IP address 10.2.2.2 and sets two as the limit of changes in version ID allowed before push partners are informed about them.
set pushpartnerconfig State=1 Server=10.2.2.2 Update=2
set replicateflag
Sets the replication flag for the specified WINS server.
Syntax
set replicateflag [State=]{0 | 1}
Parameters
- [ State=]{ 0| 1}
- Required. Indicates the setting of the replication flag: 0-Disable (replication flag off), 1-Enable (replication flag on).
Examples
In the following example, this command enables the replication flag for this server.
set replicateflag State=1
set startversion
Sets the value of the start version ID number for the database.
Syntax
set startversion [Version=]{High,Low}
Parameters
- [ Version=] {High,Low}
- Required. Specifies the start version ID number for the WINS database. High and low values are separated by a comma and enclosed by braces ({}).
Examples
In the following example, this command sets the beginning version ID number for the WINS database to 0.
set startversion Version={0,0}
show
show browser
Displays all active domain browser [1Bh] records for the specified WINS server.
Syntax
show browser
Parameters
none
show database
Displays the database and records for a partial or complete list of specified owner servers.
Syntax
show database [Servers=]{IPAddresses} [[RecType=]{0 | 1 | 2}] [[Count=]Count] [[Start=]{0 | 1}] [[EndChar=]16thCharInHex] [[File=]FileName]
Parameters
- [ Servers=] {IPAddresses}
- Required. Specifies a list of the owner servers whose records are to be displayed. Identifies owner servers by IP addresses, which must be separated by commas and enclosed in braces ({}).
- [ RecType=]{ 0| 1| 2}
- Indicates the type of record: 0-Both (default), 1-Static, 2-Dynamic.
- [ Count=] Count
- Specifies the number of records that you want to display. If unspecified, all records that match the query parameters are be returned.
- [ Start=]{ 0| 1}
- Indicates where to start sorting the display: 0-Start from the beginning of the database (default), 1-Start from the end of the database.
- [ EndChar=] 16thCharInHex
- Indicates the 16th character of the records, in hexadecimal. This number filters the records that are retrieved from the database. If unspecified, all record types are returned.
- [ File=] FileName
- Specifies the file in which formatted output is stored. If unspecified, output is displayed in the command prompt window.
Remarks
- If you specify an empty set ({}) for
Servers=, show database records are displayed for all
owner servers.
Examples
In the following example, this command outputs the first 1000 dynamic records in the WINS database for the server 10.2.2.2 to the text file output.txt.
show database Servers={10.2.2.2} RecType=2 Count=1000 Start=0 Endchar=0 File=C:\WINSfiles\output.txt
show info
Displays configuration information for the specified WINS server.
Syntax
show info
Parameters
none
Remarks
- If set, this command displays the following
WINS configuration information for the current server:
- Backup path
- Name record setting
- Periodic database consistency checking
- Burst handling
- Logging parameters
- Start version count
- Backup path
show name
Queries and displays detailed information for a specified record in the current WINS server database.
Syntax
show name [Name=]RecordName [EndChar=]16thCharInHex [[Scope=]ScopeName]
Parameters
- [ Name=] RecordName
- Required. Specifies the record for which to query.
- [ EndChar=] 16thCharInHex
- Required for all queries except unique type records. Indicates the 16th character in hexadecimal.
- [ Scope=] ScopeName]
- Specifies the NetBIOS scope, if used.
Examples
In the following example, this command shows currently stored information for name record HOSTA, of File Server type, [20h] that exists in the WINS database on the specified WINS server.
show name Name=HOSTA EndChar=20
show partner
Displays all pull partners, push partners, or pull and push partners for the specified WINS server. When used without parameters, this command displays all push partners, pull partners, and push/pull partners for the specified WINS server.
Syntax
show partner [[Type=]{0 | 1 | 2 | 3}]
Parameters
- [ Type=]{ 0| 1| 2| 3}
- Indicates the type of partner to display: 0-All (default), 1-Pull, 2-Push, 3-Both push and pull.
Examples
In the following example, this command displays the server name, IP address, and replication type of each replication partner for this WINS server.
show partner
show partnerproperties
Displays default partner configuration information for the specified WINS server.
Syntax
show partnerproperties
Parameters
none
Remarks
- This command displays the auto partner
configuration and default push/pull parameters for the current WINS
server.
show pullpartnerconfig
Displays configuration information for a pull partner.
Syntax
show pullpartnerconfig [Server=]{Name | IPAddress}
Parameters
- [ Server=]{ Name| IPAddress}
- Required. Specifies the pull partner for which you want to display configuration information. Identifies the partner by name or IP address.
Remarks
- If you provide a name that cannot be resolved
to an IP address, the function fails.
Examples
In the following example, this command displays the pull partner configuration information for WINS server 10.2.2.2.
show pullpartnerconfig Server=10.2.2.2
show pushpartnerconfig
Displays configuration information for a push partner.
Syntax
show pushpartnerconfig [Server=]{Name | IPAddress}
Parameters
- [ Server=]{ Name| IPAddress}
- Required. Specifies the push partner for which you want to display configuration information. Identifies the push partner by name or IP address.
Remarks
- If you provide a name that cannot be resolved
to an IP address, the function fails.
Examples
In the following example, this command displays the push partner configuration information for WINS server 10.2.2.2.
show pushpartnerconfig Server=10.2.2.2
show recbyversion
Displays a set of records for an owner, specified as a range of version IDs, and sorts the records by version.
Syntax
show recbyversion [Server=]IPAddress [MaxVer=]{High,Low} [MinVer=]{High,Low} [[Name=]RecordName] [[EndChar=]16thChar] [Case=]{0 | 1}
Parameters
- [ Server=] IPAddress
- Required. Specifies the owner server for which you want to display a set of records. Identifies the server by IP address.
- [ MaxVer=] {High,Low}
- Required. Specifies the range of records to return by the maximum high and low version number. High and low values are separated by a comma and enclosed by braces ({}).
- [ MinVer=] {High,Low}
- Required. Specifies the range of records to return by minimum high and the minimum low version number. High and low values are separated by a comma and enclosed by braces ({}).
- [ Name=] RecordName
- Specifies the records for which to look.
- [ EndChar=] 16thChar
- Indicates the character for which to look, in hexadecimal.
- [ Case=]{ 0| 1}
- Indicates whether to create a case-sensitive comparison: 0-Ignore case (default), 1-Create a case-sensitive comparison.
Remarks
- If Name= is not specified,
EndChar= and Case= are ignored.
- If you set both MinVer= and
MaxVer= to {0,0}, show recbyversion displays the
entire range of records.
Examples
In the following example, this command displays the total number of records (by record version) owned by WINS server 10.2.2.2.
show recbyversion Server=10.2.2.2 MaxVer={0,0} MinVer={0,0} Name=dc1 EndChar=1c Case=0
show reccount
Displays the number of records owned by a specific WINS server.
Syntax
show reccount [Server=]IPAddress [MaxVer=]{High,Low} [MinVer=]{High,Low}
Parameters
- [ Server=] IPAddress
- Required. Specifies the owner server for which you want to display the number of records. Identifies the server by IP address.
- [ MaxVer=] {High,Low}
- Required. Specifies the maximum high and low version of records to show. High and low values are separated by a comma and enclosed by braces ({}).
- [ MinVer=] {High,Low}
- Required. Specifies the minimum high and low version of records to show. High and low values are separated by a comma and enclosed by braces ({}).
Remarks
- If you set both MinVer= and
MaxVer= to {0,0}, show reccount counts the entire
range of records.
Examples
In the following example, this command shows the total record count for WINS server 10.2.2.2.
show reccount Server=10.2.2.2 MaxVer={0,0} MinVer={0,0}
show server
Displays information for the specified WINS server.
Syntax
show server
Parameters
none
Remarks
- This command displays the name and IP address
of the specified WINS server.
show serverstatistics
Displays statistics for the specified WINS server.
Syntax
show statistics
Parameters
none
show version
Displays the current maximum version counter value for the specified WINS server.
Syntax
show version
Parameters
none
show versionmap
Displays the owner ID to maximum version number mappings table for the specified WINS server.
Syntax
show versionmap
Parameters
none