Get-TcRouterConfig
SYNOPSIS
Gets the remote connection configuration (static, trusted, and untrusted routes) from a TwinCAT target system via ADS.
SYNTAX
Get-TcRouterConfig [[-Address] <String[]>] [-InputObject <IRoute>]
[<CommonParameters>]
DESCRIPTION
This cmdlet reads the ADS route configuration files from a local or remote TwinCAT system and returns them grouped into three categories: StaticConnections (from StaticRoutes.xml), TrustedConnections (accepted certificates), and UntrustedConnections (pending certificates). The cmdlet connects to the target's System Service (port 10000) and reads the configuration files via ADS file access. If no -Destination is specified, the local system is queried.
EXAMPLES
Example 1
PS> Get-TcRouterConfig
StaticConnections
-----------------
Name NetId Address Type Security
---- ----- ------- ---- --------
CX-123456 172.19.241.154.1.1 172.26.1.173 TCP_IP None
PLC-East 172.17.62.146.1.1 172.17.62.146 TCP_IP None
TrustedConnections
------------------
(none)
UntrustedConnections
--------------------
(no connections)
Get remote connections from the local system.
Example 2
PS> $route = Get-AdsRoute -Name 'CX-123456'
PS> Get-TcRouterConfig -Destination $route
StaticConnections
-----------------
Name NetId Address Type Security
---- ----- ------- ---- --------
Engineering-PC 10.1.2.100.1.1 10.1.2.100 TCP_IP None
TrustedConnections
------------------
(none)
UntrustedConnections
--------------------
(no connections)
Get router configuration from a specific remote target.
PARAMETERS
-Address
The Name / Address of the route to get. The address of the route can be coded as NetId, the HostName or the IPAddress in string representation. Wildcards are permitted. Tab completion: Completes route names from currently reachable ADS systems on the local TwinCAT system. The address.
Type: String[]
Parameter Sets: (All)
Aliases: Name
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-InputObject
The Destination address specifies the target source, where the routes are determined. Use this to get the registered routes of a remote system. The Destination system can be specified by RouteName (route name on local system), AmsNetId, IPAddress or HostName. The destination system must be reachable by the local registered routes. Tab completion: Completes route names from currently reachable ADS systems on the local TwinCAT system. The input object.
Type: IRoute
Parameter Sets: (All)
Aliases: Destination
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.