Share via


W32tm

 

Applies To: Windows Server 2003, Windows SBS 2003, Windows Vista, Windows XP, Windows Home Server 2011, Windows HPC Server 2008 R2, Windows Server 2008, Windows 7, Windows Server 2003 R2, Windows Server 2008 R2, Windows Essential Business Server, Windows Server 2008 Foundation, Windows SBS 2008, Windows Server 2008 R2 Foundation, Windows Home Server, Windows Server 2012, Windows HPC Server 2008, Windows 8

You can use the W32tm.exe tool to configure Windows Time service (W32time) settings. You can also use W32tm.exe to diagnose problems with the time service. W32tm.exe is the preferred command-line tool for configuring, monitoring, or troubleshooting the Windows Time service. For examples of how you can use this command, see Examples.

Syntax

W32tm </parameter> </param2>

Parameters

Parameter

Description

W32tm /?

W32tm command-line Help

W32tm /register

Registers the time service to run as a service, and adds default configuration to the registry.

W32tm /unregister

Unregisters the time service, and removes all configuration information from the registry.

w32tm /monitor

[/domain:<domain name>] [/computers:<name>[,<name>[,<name>...]]] [/threads:<num>]

Domain—Specifies which domain to monitor. If no domain name is specified, or neither the domain nor computers option is specified, the default domain is used. This option might be used more than once.

computers—Monitors the given list of computers. Computer names are separated by commas, with no spaces. If a name has a prefix of a ‘*’, it is treated as a primary domain controller (PDC). You can use this option more than once.

threads—Specifies the number of computers to analyze simultaneously. The default value is 3. The allowed range is 1 through 50.

w32tm /ntte <NT time epoch>

Converts a Windows NT system time, in (10^-7)s intervals from 0h 1-Jan 1601, into a readable format.

w32tm /ntpte <NTP time epoch>

Converts a Network Time Protocol (NTP) time, in (2^-32)s intervals from 0h 1-Jan 1900, into a readable format.

w32tm /resync

[/computer:<computer>]

[/nowait]

[/rediscover]

[/soft]

Tells a computer that it should resynchronize its clock as soon as possible, throwing out all accumulated error statistics.

computer:<computer>—Specifies the computer that should resynchronize. If a computer is not specified, the local computer will resynchronize.

nowait—Do not wait for the resynchronization to occur; return immediately. Otherwise, wait for the resynchronization to complete before returning.

rediscover—Redetect the network configuration and rediscover network sources; then, resynchronize.

soft—This option is only provided for compatibility with older time servers and will resynchronize using existing error statistics..

w32tm /stripchart

/computer:<target>

[/period:<refresh>]

[/dataonly]

[/samples:<count>]

[/packetinfo]

[ipprotocol:<4|6>

Displays a strip chart of the offset between this computer and another computer.

computer:<target>—The computer to measure the offset against.

period:<refresh>—The time between samples, in seconds. The default value is 2 seconds.

Dataonly—Display only the data, without graphics.

samples:<count>—Collect <count> samples; then, stop. If a value is not specified, samples will be collected until the user types Ctrl+C is pressed.

packetinfo—Print out NTP packet response message.

Ipprotocol—Specify the IP protocol to use. The default is to use whatever is available.

w32tm /config

[/computer:<target>]

[/update]

[/manualpeerlist:<peers>]

[/syncfromflags:<source>]

[/LocalClockDispersion:<seconds>]

[/reliable:(YES|NO)]

[/largephaseoffset:<milliseconds>]

computer:<target>—Adjusts the configuration of <target>. If a value is not specified, the default is the local computer.

update—Notifies the time service that the configuration has changed, causing the changes to take effect.

manualpeerlist:<peers>—Sets the manual peer list to <peers>, which is a space-delimited list of Domain Name System (DNS) and/or IP addresses. When you are specifying multiple peers, this option must be enclosed in quotation marks (“).

syncfromflags:<source>—Sets what sources the NTP client should synchronize from. <source> should be a comma-separated list of these keywords (not case sensitive):

  • MANUAL— Include peers from the manual peer list.

  • DOMHIER— Synchronize from a domain controller in the domain hierarchy.

  • NO—Do not synchronize from any server.

  • ALL—Synchronize from both manual and domain peers.

LocalClockDispersion:<seconds>—Configures the accuracy of the internal clock that W32time will assume when it cannot acquire time from its configured sources.

reliable:(YES|NO)—Set whether this computer is a reliable time source.

This setting is meaningful only on domain controllers.

  • YES—This computer is a reliable time service.

  • NO—This computer is not a reliable time service.

largephaseoffset:<milliseconds>—Sets the time difference between local time and network time that W32time will consider to be a spike.

w32tm /tz

Displays the current time zone settings.

w32tm /dumpreg

[/subkey:<key>]

[/computer:<target>]

Displays the values that are associated with a given registry key.

The default key is HKLM\System\CurrentControlSet\Services\W32Time

(the root key for the time service).

subkey:<key>—Displays the values that are associated with subkey <key> of the default key.

computer:<target>—Queries registry settings for computer <target>.

w32tm /query [/computer:<target>] {/source | /configuration | /peers | /status} [/verbose]

This parameter was first made available in the Windows Time client versions of Windows Vista, and Windows Server 2008.

Displays a computer's Windows Time service information.

computer:<target>—Query the information of <target>. If a value is not specified, the default value is the local computer.

source—Display the time source.

configuration—Display the configuration of run time and where the setting comes from. In verbose mode, display the undefined or unused setting also.

peers—Display a list of peers and their status.

status—Display Windows Time service status.

verbose—Set the verbose mode to display more information.

w32tm /debug {/disable | {/enable /file:<name> /size:<bytes> /entries:<value> [/truncate]}}

This parameter was first made available in the Windows Time client versions of Windows Vista and Windows Server 2008.

Enables or disables local computer Windows Time service private log.

disable—Disable the private log.

enable—Enable the private log.

  • file:<name>—Specify the absolute file name.

  • size:<bytes>—Specify the maximum size for circular logging.

  • entries:<value>—Contains a list of flags, specified by number and separated by commas, that specify the types of information that should be logged. Valid numbers are 0 to 300. A range of numbers is valid, in addition to single numbers, such as 0 through 100,103,106. Value 0-300 is for logging all information.

truncate—Truncate the file if it exists.

Remarks

The Windows Time service is not a full-featured NTP solution that meets time-sensitive application needs, and it is not supported by Microsoft as such. For more information, see article 939322 in the Microsoft Knowledge Base (https://go.microsoft.com/fwlink/?LinkID=179459).

If you have questions about the Windows Time service, please post them to the Directory Services forum (https://go.microsoft.com/fwlink/?LinkId=195451).

Examples

If you want to set the local Windows Time client to point to two different time servers, one named ntpserver.contoso.com and another named clock.adatum.com, type the following command at the command line, and then press ENTER:

w32tm /config /manualpeerlist:"ntpserver.contoso.com clock.adatum.com" /syncfromflags:manual /update

For a list of valid NTP servers that are available on the Internet for external time synchronization, see article 262680 in the Microsoft Knowledge Base (https://go.microsoft.com/fwlink/?LinkID=60401).

If you want to check the Windows Time client configuration from a client computer running Windows 7 that has a host name of CONTOSOW1, run the following command:

W32tm /query /computer:contosoW1 /configuration

The output of this command is a list of configuration parameters that are set for the Windows Time client.

Additional references