Topic Last Modified: 2010-10-01
Retrieves one or more subnets from the location configuration database. Each subnet can be associated with a location, in which case this cmdlet will also retrieve the location information of the subnets. This location association is used in an Enhanced 9-1-1 (E9-1-1) Enterprise Voice implementation to notify an emergency services operator of the caller’s location.
Syntax
Get-CsLisSubnet
|
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
None |
This cmdlet provides only common Windows PowerShell parameters. |
Detailed Description
Enhanced 9-1-1 allows an emergency operator to identify the location of a caller without having to ask the caller for that information. In the case where a caller is calling from a Voice over Internet Protocol (VoIP) connection, that information must be extracted based on various connection factors. The VoIP administrator must configure a location map (called a wiremap) that will determine a caller’s location. This cmdlet retrieves information on associations between physical locations and the subnet through which calls are routed.
This cmdlet does not take any parameters (other than the Windows PowerShell common parameters). The cmdlet will retrieve all instances of subnet to location mappings. To narrow down the information retrieved, you must pipe the output from this cmdlet to another Windows PowerShell cmdlet such as Where-Object or Select-Object.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsLisSubnet cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsLisSubnet"}
Input Types
None.
Return Types
This cmdlet retrieves an object of type System.Management.Automation.PSCustomObject.
Example
-------------------------- Example 1 --------------------------
Copy Code | |
---|---|
Get-CsLisSubnet |
Example 1 retrieves all Location Information Server (LIS) subnets that have been defined in the Microsoft Lync Server 2010 deployment.
-------------------------- Example 2 --------------------------
Copy Code | |
---|---|
Get-CsLisSubnet | Where-Object {$_.Subnet -eq "192.0.10.0"} |
This example retrieves all information for the subnet with the IP address 192.0.10.0. The command begins by calling Get-CsLisSubnet to retrieve all subnet location associations. This collection of subnet locations is piped to the Where-Object cmdlet. Where-Object checks the Subnet property of each item in the collection to determine whether the value is equal to (-eq) 192.0.10.0. Because the Subnet ID must be unique, this command will return, at most, one object.