The following commands are specific to the ras diagnostics context within the Netsh environment.
To view the command syntax, click a command:
Set commands
Show commands
- show all
- show cmtracing
- show configuration
- show installation
- show loglevel
- show logs
- show modemtracing
- show rastracing
- show
securityeventlog
- show
tracefacilities
Netsh commands for RAS diagnostics
The following entries provide details for each command.
dump
Displays the configuration of Remote Access Diagnostics in script form.
Syntax
dump
Remarks
- You can dump the contents of the current
configuration to a file that can be used to restore altered
configuration settings.
Example
The following commands save the current configuration as a script in the c:\test\rasdiagcfg.dmp file.
- From the command prompt:
netsh ras diagnostics dump > c:\test\rasdiagcfg.dmp
- From the netsh ras diagnostics context
prompt:
set file open c:\test\rasdiagcfg.dmp
dump
set file close
You can use the netsh exec command to run the script created by the netsh dump command.
show installation
Creates a Remote Access Diagnostic Report that includes only diagnostics results for Information Files, Installation Check, Installed Networking Components, and Registry Check and delivers the report to a location you specify.
Syntax
show installation
[ type = ] { file | email }
[ destination = ] { FileLocation | EmailAddress }
[ [ compression = ] { enabled | disabled } ]
[ [ hours = ] NumberOfHours ]
[ [ verbose = ] { enabled | disabled } ]
Parameters
- [ type = ] { file | email }
- Specifies whether the report should be saved to a file or sent to an e-mail address.
- [ destination = ] { FileLocation | EmailAddress }
- Required. Specifies the full path and file name to which the report should be saved or the full e-mail address to which the report should be sent. If there are any spaces, you must place the parameter inside quotation marks.
- [ compression = ] { enabled | disabled }
- Specifies whether to compress the report into a .cab file. If you do not specify this parameter, the report is compressed if you send it to an e-mail address but not if you save it to a file.
- [ hours = ] NumberOfHours
- Specifies the number of past hours for which to show activity in the report. This parameter must be an integer between 1 and 24. If you do not specify this parameter, all past information is included.
- [ verbose = ] { enabled | disabled }
- Specifies the amount of data to include in the report. If you do not specify this parameter, only minimal data is included.
Remarks
- When saved as a file, the Remote Access
Diagnostic Report is saved as an HTML file (.htm).
Example
To save a diagnostic report to c:\test\rasdiag.htm, type:
show installation type=file destination="c:\test\rasdiag.htm"
show loglevel
Shows the global logging level for Routing and Remote Access service.
Syntax
show loglevel
set loglevel
Sets the global logging level for Routing and Remote Access service.
Syntax
set loglevel
[ state = ] { error | warn | all | none }
Parameters
- [ state = ] { error | warn | all | none }
- Required. Specifies the level of global logging. The none parameter specifies that no events are logged. The error parameter specifies that only errors are logged. The warn parameter specifies that errors and warnings are logged. The all parameter specifies that all events are logged.
show logs
Creates a Remote Access Diagnostic Report that contains only diagnostics results for Tracing Logs, Modem Logs, Connection Manager Logs, IP Security Log, Remote Access Event Logs, and Security Event Logs and delivers the report to a location you specify.
Syntax
show logs
[ type = ] { file | email }
[ destination = ] { FileLocation | EmailAddress }
[ [ compression = ] { enabled | disabled } ]
[ [ hours = ] NumberOfHours ]
[ [ verbose = ] { enabled | disabled } ]
Parameters
- [ type = ] { file | email }
- Specifies whether the report should be saved to a file or sent to an e-mail address.
- [ destination = ] { FileLocation | EmailAddress }
- Required. Specifies the full path and file name to which the report should be saved or the full e-mail address to which the report should be sent. If there are any spaces, you must place the parameter inside quotation marks.
- [ compression = ] { enabled | disabled }
- Specifies whether to compress the report into a .cab file. If you do not specify this parameter, the report is compressed if you send it to an e-mail address but not if you save it to a file.
- [ hours = ] NumberOfHours
- Specifies the number of past hours for which to show activity in the report. This parameter must be an integer between 1 and 24. If you do not specify this parameter, all past information is included.
- [ verbose = ] { enabled | disabled }
- Specifies the amount of data to include in the report. If you do not specify this parameter, only minimal data is included.
Remarks
- When saved as a file, the Remote Access
Diagnostic Report is saved as an HTML file (.htm).
Example
To save a diagnostic report to c:\test\rasdiag.htm, type:
show logs type=file destination="c:\test\rasdiag.htm"
show configuration
Creates a Remote Access Diagnostic Report that includes only diagnostics results for Installed Devices, Process Information, Command-line Utilities, and Phone Book Files and delivers the report to a location you specify.
Syntax
show configuration
[ type = ] { file | email }
[ destination = ] { FileLocation | EmailAddress }
[ [ compression = ] { enabled | disabled } ]
[ [ hours = ] NumberOfHours ]
[ [ verbose = ] { enabled | disabled } ]
Parameters
- [ type = ] { file | email }
- Specifies whether the report should be saved to a file or sent to an e-mail address.
- [ destination = ] { FileLocation | EmailAddress }
- Required. Specifies the full path and file name to which the report should be saved or the full e-mail address to which the report should be sent. If there are any spaces, you must place the parameter inside quotation marks.
- [ compression = ] { enabled | disabled }
- Specifies whether to compress the report into a .cab file. If you do not specify this parameter, the report is compressed if you send it to an e-mail address but not if you save it to a file.
- [ hours = ] NumberOfHours
- Specifies the number of past hours for which to show activity in the report. This parameter must be an integer between 1 and 24. If you do not specify this parameter, all past information is included.
- [ verbose = ] { enabled | disabled }
- Specifies the amount of data to include in the report. If you do not specify this parameter, only minimal data is included.
Remarks
- When saved as a file, the Remote Access
Diagnostic Report is saved as an HTML file (.htm).
Example
To save a diagnostic report to c:\test\rasdiag.htm, type:
show configuration type=file destination="c:\test\rasdiag.htm"
show all
Creates a Remote Access Diagnostic Report for all remote access logs and delivers the report to a location you specify.
Syntax
show all
[ type = ] { file | email }
[ destination = ] { FileLocation | EmailAddress }
[ [ compression = ] { enabled | disabled } ]
[ [ hours = ] NumberOfHours ]
[ [ verbose = ] { enabled | disabled } ]
Parameters
- [ type = ] { file | email }
- Specifies whether the report should be saved to a file or sent to an e-mail address.
- [ destination = ] { FileLocation | EmailAddress }
- Required. Specifies the full path and file name to which the report should be saved or the full e-mail address to which the report should be sent. If there are any spaces, you must place the parameter inside quotation marks.
- [ compression = ] { enabled | disabled }
- Specifies whether to compress the report into a .cab file. If you do not specify this parameter, the report is compressed if you send it to an e-mail address but not if you save it to a file.
- [ hours = ] NumberOfHours
- Specifies the number of past hours for which to show activity in the report. This parameter must be an integer between 1 and 24. If you do not specify this parameter, all past information is included.
- [ verbose = ] { enabled | disabled }
- Specifies the amount of data to include in the report. If you do not specify this parameter, only minimal data is included.
Remarks
- When saved as a file, the Remote Access
Diagnostic Report is saved as an HTML file (.htm).
- The Remote Access Diagnostic Report that you
create by using the show all command contains all diagnostic
information available. You can use other commands, such as show
configuration, to create reports that contain a narrower scope
of information.
Example
To save a diagnostic report to c:\test\rasdiag.htm that includes all diagnostic information, type:
show all type=file destination="c:\test\rasdiag.htm"
show cmtracing
Shows whether information about Connection Manager connections is being logged.
Syntax
show cmtracing
set cmtracing
Enables or disables logging of information about all Connection Manager connections.
Syntax
set cmtracing { enabled | disabled }
Parameters
- { enabled | disabled }
- Required. Specifies whether you want information about Connection Manager connections to be logged. The enabled parameter specifies that you want information to be logged. The disabled parameter specifies that you do not want information to be logged.
Remarks
- Each log file for a Connection Manager
connection contains information that is specific to the history of
that connection. Each Connection Manager connection generates a
unique log file. Depending on the configuration of the connection,
the log file might be saved in any of various locations.
- This command will be overridden for a
particular connection if the user enables or disables logging for
that connection or if the user installs and uses a Connection
Manager profile for which an administrator has enabled or disabled
logging.
show modemtracing
Shows whether modem tracing is enabled or disabled.
Syntax
show modemtracing
set modemtracing
Enables or disables modem tracing for all modems installed for the local computer.
Syntax
set modemtracing { enabled | disabled }
Parameters
- { enabled | disabled }
- Required. Specifies whether you want modem activity for each modem to be logged. The enabled parameter specifies that you want activity to be logged. The disabled parameter specifies that you do not want activity to be logged.
Remarks
- This command enables or disables the logging
of modem activity for all modems. If you want to enable or disable
modem logging for a specific modem, you should configure the modem
in Device Manager.
show rastracing
Shows whether tracing for the given component is enabled. If no component is specified, shows the state of all components.
Syntax
show rastracing [ component = ] Component
Parameters
- [ component = ] Component
- Specifies the component for which you want to determine whether tracing is enabled or disabled. If no component is specified, the state of all components is displayed.
set rastracing
Enables or disables tracing and logging of all activity for all remote access components or for a specific remote access component.
Syntax
set rastracing
[ component = ] { Component | *} { enabled | disabled }
[ state = ] { enabled | disabled }
Parameters
- [ component = ] { Component | *}
- Required. Specifies whether you want to enable or disable tracing and logging for a component that you specify or for all components. The Component parameter specifies the component for which you want to enable or disable tracing and logging. Use '*' to denote all components.
- [ state = ] { enabled | disabled }
- Required. Specifies whether you want activity to be traced and logged. The enabled parameter specifies that you want activity to be traced and logged. The disabled parameter specifies that you do not want activity to be traced and logged.
Remarks
- If you enable tracing and logging, a log file
named Component.log is created in the %windir%\tracing
directory for each component being traced.
show securityeventlog
Shows whether security events are being logged.
Syntax
show securityeventlog
set securityeventlog
Enables or disables logging of all security events.
Syntax
set securityeventlog
[ state = ] { enabled | disabled }
Parameters
- [ state = ] { enabled | disabled }
- Required. Specifies whether you want security events to be logged. The enabled parameter specifies that you want security events to be logged. The disabled parameter specifies that you do not want security events to be logged.
Remarks
- You can also view security event logs in the
Event Viewer.
show tracefacilities
Shows whether all activity for all remote access components or for a remote access component that you specify is being traced and logged.
Syntax
show tracefacilities
set tracefacilities
Enables or disables tracing and logging of all activity for all remote access components that are configured on the local computer.
Syntax
set tracefacilities
[ state= ] { enabled | disabled | clear }
Parameters
- [ state = ] { enabled | disabled | clear }
- Required. Specifies whether you want to enable tracing for all remote access components, to disable tracing, or to clear all logs generated by tracefacilities. The enabled parameter specifies that you want to enable tracing. The disabled parameter specifies that you want to disable tracing. The clear parameter specifies that you want to clear all logs.