Retrieves one or more call admission control (CAC) or E911 network sites.
Syntax
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>] |
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Optional |
XdsGlobalRelativeIdentity |
The unique identifier of the network site you want to retrieve. Sites are created only at the global scope, so you do not need to specify a scope. Instead, you need to specify only the site ID. |
|
Filter |
Optional |
String |
A wildcard string that allows you to retrieve multiple sites based on matching the site Identity to the Filter value. |
|
LocalStore |
Optional |
SwitchParameter |
Retrieves the network site information from the local replica of the Central Management database, rather than the Central Management database itself. |
Detailed Description
Network sites are the offices or locations configured within each region of a CAC or E911 deployment. This cmdlet retrieves the settings for one or more existing sites.
Return Types
Retrieves an object of type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Get-CsNetworkSite |
|
Calling Get-CsNetworkSite with no parameters will return all network sites configured for CAC or E911 within the Microsoft Communications Server 2010 deployment.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Get-CsNetworkSite -Identity Redmond |
|
This command retrieves the site with the Identity (and, by definition, the NetworkSiteID) Redmond.
-------------------------- Example 3 --------------------------
| Copy Code |
|
|---|---|
Get-CsNetworkSite -Filter NA* |
|
The command in Example 3 calls Get-CsNetworkSite with the Filter parameter. The value of the Filter parameter is NA*, meaning that this command will retrieve all sites with an Identity (or NetworkSiteID) beginning with the string NA and followed by any number of characters. This will return sites such as NARedmond, NAVancouver, and NAChicago.
-------------------------- Example 4 --------------------------
| Copy Code |
|
|---|---|
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
|
|
Example 4 uses two cmdlets, Get-CsNetworkSite and Where-Object, to retrieve all the sites that are are part of the NorthAmerica region. The command begins by calling Get-CsNetworkSite with no parameters to retrieve all network sites. This collection of sites is then piped to Where-Object, which filters the collection, looking for all sites in the collection where the NetworkRegionID property is equal to (-eq) NorthAmerica.