[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

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.