Get-RAS Cmdlet

Parameters   Output Objects   Configuration Settings  

The Get-RAS component can be used to call the Remote Access System (RAS) to list connections, devices and phonebook entries.

Syntax

Get-RAS [parameters]

Remarks

To retrieve a list of all connections in all devices, set the ListConnections switch to retrieve zero or more Connections.

To retrieve a list of the dial devices on the system, you can set the ListDevices switch to retrieve zero or more Devices.

For a list of phonebook entries, set the ListPhonebook switch to return zero or more Entrys. If more than one phonebook is available, you can specify the phonebook in the Phonebook parameter.

Support is also provided for creating and/or deleting phonebook entries. To do this, set the SET-RAS cmdlet.

The cmdlets support pipeline input for some of their parameters. Prebuilding an object and piping it to the cmdlet is very useful, but should be used with caution to prevent security conflicts. Steps have been taken to decrease the risk of a possibly accidental pipe to the cmdlet, for instance, the Credential parameter cannot be piped to the cmdlet and must be specified manually.

# list devices 
get-ras -listdevices
# list connections
get-ras -listconnections
# list entries in the phonebook "My Phonebook"
get-ras -listphonebook -phonebook "My Phonebook"