Edit

Share via


Get-CsNetworkInterSitePolicy

Retrieves one or more network inter-site policies, which define bandwidth limitations between sites that are directly linked within a call admission control (CAC) configuration. This cmdlet was introduced in Lync Server 2010.

Syntax

Identity

Get-CsNetworkInterSitePolicy
    [[-Identity] <XdsGlobalRelativeIdentity>]
    [-LocalStore]
    [<CommonParameters>]

Filter

Get-CsNetworkInterSitePolicy
    [-Filter <String>]
    [-LocalStore]
    [<CommonParameters>]

Description

When network sites share a direct link, bandwidth limitations for audio and video connections can be defined between those two sites. This cmdlet retrieves one or more network site policies that associate bandwidth limitation settings with directly connected sites.

Examples

Example 1

Get-CsNetworkInterSitePolicy

Calling the Get-CsNetworkInterSitePolicy cmdlet with no parameters retrieves all network site policies defined between two directly linked network sites.

Example 2 (Lync Server 2010)

Get-CsNetworkInterSitePolicy -Identity Reno_Portland

This example retrieves the network site policy with the Identity Reno_Portland.

Example 3

Get-CsNetworkInterSitePolicy -Filter *Reno*

Example 3 retrieves all network site policies that have the string Reno anywhere within the Identity value. The wildcard characters (*) within the value passed to the Filter parameter signify "any character or set of characters." In other words, the string Reno will match Identity values that begin with any character or characters, followed by the string Reno, followed by any character or characters.

Example 4

Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}

This example retrieves all network site policies that do not have a bandwidth policy profile assigned. The command begins by calling the Get-CsNetworkInterSitePolicy cmdlet, which, as we saw in Example 1, retrieves a collection of all network site policies. This collection is then piped to the Where-Object cmdlet. The Where-Object cmdlet narrows the collection down to only those site policies that don't have a bandwidth policy profile assigned. It does this by comparing to see if the BWPolicyProfileID property of each site policy is equal to (-eq) Null ($null).

Parameters

-Filter

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

A string containing wildcard characters that will search for policies with Identity values matching the wildcard string.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The unique identifier of the network site policy you want to retrieve. Network site policies are created only at the global scope, so this identifier does not need to specify a scope. Instead, it contains a string that is a unique name that identifies that policy.

Parameter properties

Type:XdsGlobalRelativeIdentity
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identity
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LocalStore

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Retrieves the network inter-site policy information from the local replica of the Central Management store, rather than the Central Management store itself.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType