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

Creates a new call admission control (CAC) or E911 network site.

Syntax

New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSite -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Identity

Required

XdsGlobalRelativeIdentity

A unique identifier for the newly-created network site. Sites are created only at the global scope, so this identifier does not need to specify a scope. Instead, it contains a string that is unique among all sites within the Microsoft Communications Server 2010 deployment.

NetworkSiteID

Required

String

This value is the same as the Identity. You cannot specify both an Identity and a NetworkSiteID; a value entered for one will be automatically used for both.

BWPolicyProfileID

Optional

String

The Identity of the bandwidth policy profile that will define the limitations for this site. You can retrieve a list of available profiles by calling the Get-CsNetworkBandwidthPolicyProfile cmdlet.

BypassID

Optional

String

A globally unique identifier (GUID). This GUID is used to map network sites to media bypass settings within a CAC or E911 network configuration. (Use this BypassID value in the call to New-CsNetworkMediaBypassConfiguration.)

If you do not specify a value for this parameter, a value will be automatically generated, but only if you supply a value for the NetworkRegionID parameter. If you do not supply a NetworkRegionID parameter, no BypassID will be generated. You also cannot explicitly supply a value for the BypassID parameter without also supplying a value for the NetworkRegionID parameter.

If you explicitly specify a value, it must be in the format of a GUID (for example, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Auto-generation is recommended.

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

Description

Optional

String

A string that describes the site. This parameter can be used to provide a more descriptive explanation of what the site is for or where it is than can be expressed by the Identity alone.

Force

Optional

SwitchParameter

InMemory

Optional

SwitchParameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

LocationPolicy

Optional

String

The name of the location policy associated with this site. The location policy assigns specific E911 settings to the site.

NetworkRegionID

Optional

String

The Identity of the network region that this site is associated with. This parameter must contain a value if you want to provide a BypassID (either through auto-generation or manually).

WhatIf

Optional

SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Detailed Description

Network sites are the offices or locations configured within each region of a CAC or E911 deployment. This cmdlet creates a new site and associates it with a region. A CAC network site must be created for every site within an organization, even if that site has no bandwidth limitations.

The only parameter required to create a network site is the Identity. However, this simply creates an empty site with no associations to regions and will therefore be of no use until properties such as NetworkRegionID are supplied with values.

Return Types

Create an object of type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.

Examples

-------------------------- Example 1 --------------------------

Copy Code
New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica

In this example a new network site named Vancouver is created. The site name is specified as the value for the Identity parameter. A value is also specified for the NetworkRegionID parameter, which associates the site with the region – in this example – NorthAmerica. Because a NetworkRegionID has been supplied but no value has been specified for BypassID (the recommended scenario), a BypassID value will be automatically generated.

Notice that the command in this example did not include the BWPolicyProfileID parameter. Unless (or until) a value is added later using Set-CsNetworkSite, this site will have no bandwidth limitations for media connections.

-------------------------- Example 2 --------------------------

Copy Code
New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA - BWPolicyProfileID LowBWLimits

In Example 2 we create a new network site named Paris. The site name is specified as the value for the Identity parameter. As in Example 1 we also specify a value for the NetworkRegionID, this time the region EMEA. Once again we are following the recommended path by allowing the cmdlet to generate the BypassID. Unlike Example 1, this example also specifies a value for the BWPolicyProfileID parameter: LowBWLimits. The policies associated with that profile will be used for this site.