Compartilhar via


Netsh commands for WINS

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Netsh commands for WINS

The Netsh commands for 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 2003 family command prompt or from the command prompt for the Netsh wins context. For these commands to work at the Windows Server 2003 family command prompt, you must type netsh wins before typing commands and parameters as they appear in the syntax below. There might be functional differences between Netsh context commands on Windows 2000 and the Windows Server 2003 family.

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 and Persona Grata refer to the Windows Server 2003 family features Block records for these owners and Accept records only for these owners, respectively.

  • For more information about Netsh, see Netsh overview and Enter a netsh context.

  • For an example of how to use Netsh commands for WINS in batch files and scripts, see Netsh WINS example.

  • For more information about how to use the Netsh commands for WINS, see Use WINS Command-line Tools.

Netsh WINS

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

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 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 Persona Grata (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 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 a 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 Persona Non Grata (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 Persona Non Grata 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 be 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 a 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 an invalid file name, 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 Persona Grata servers or specific Persona Grata servers from the list of Persona Grata 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 Persona Grata 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 Persona Non Grata servers or specific Persona Non Grata servers from the list of Persona Non Grata 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 Persona Non Grata 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 the minimum 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 maximum 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 the maximum 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 the minimum 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 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.

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

    If you specify a value for EndChar=, only records that match the record name and record type are returned. For example, if the value for Name= is MYPC and the value for EndChar is 00, the following search results return:

    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 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 Time to Live (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 Persona Grata mode. During replication, WINS will accept only the records that are owned by the servers that are specified in the Persona Grata 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=, execution of 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 beginning (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 master 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

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 the maximum 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 the maximum 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 the minimum 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

Formatting legend

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

See Also

Concepts

Netsh commands for AAAA
Netsh commands for DHCP
Netsh diagnostic (diag) commands
Netsh commands for Interface IP
Netsh commands for remote access (ras)
Command-line reference A-Z
Command shell overview