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.