From 3a2f6d51c39f183c4e1097d360e0e8d34b0305db Mon Sep 17 00:00:00 2001 From: Teddy Gyabaah <120189631+teddygyabaah@users.noreply.github.com> Date: Thu, 24 Oct 2024 11:14:45 +0300 Subject: [PATCH 1/2] Update Set-CsOnlinePSTNGateway.md --- teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md b/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md index 86e8fc70c2..76de2aa1c0 100644 --- a/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md +++ b/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md @@ -22,7 +22,7 @@ Set-CsOnlinePSTNGateway [[-Identity] ] [-BypassMode ] [-Descript [-FailoverResponseCodes ] [-FailoverTimeSeconds ] [-ForwardCallHistory ] [-ForwardPai ] [-GatewayLbrEnabledUserOverride ] [-GatewaySiteId ] [-GatewaySiteLbrEnabled ] [-InboundPstnNumberTranslationRules ] [-InboundTeamsNumberTranslationRules ] [-MaxConcurrentSessions ] [-MediaBypass ] [-MediaRelayRoutingLocationOverride ] [-OutboundPstnNumberTranslationRules ] - [-OutboundTeamsNumberTranslationRules ] [-PidfLoSupported ] [-ProxySbc ] [-SendSipOptions ] [-SipSignalingPort ] + [-OutboundTeamsNumberTranslationRules ] [-PidfLoSupported ] [-ProxySbc ] [-SendSipOptions ] [-SipSignalingPort ] [-IPAddressVersion ] [-WhatIf] [-Confirm] [] ``` @@ -378,6 +378,20 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -IPAddressVersion +Possible values are "IPv4" and '"Pv6". When "IPv6" is set, the SBC must use IPv6 for both signaling and media. **Note: IPv6 is supported only for non-media bypass scenarios.** + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. From 807209e2f49696010db9eb978da9dde5348c2bec Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Tue, 3 Dec 2024 15:10:37 -0800 Subject: [PATCH 2/2] Update Set-CsOnlinePSTNGateway.md --- .../teams-ps/teams/Set-CsOnlinePSTNGateway.md | 194 ++++++++++-------- 1 file changed, 107 insertions(+), 87 deletions(-) diff --git a/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md b/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md index f59705df58..730f2e4a67 100644 --- a/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md +++ b/teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md @@ -18,12 +18,32 @@ Modifies the previously defined Session Border Controller (SBC) Configuration th ## SYNTAX ``` -Set-CsOnlinePSTNGateway [[-Identity] ] [-BypassMode ] [-Description ] [-Enabled ] - [-FailoverResponseCodes ] [-FailoverTimeSeconds ] [-ForwardCallHistory ] [-ForwardPai ] [-GatewayLbrEnabledUserOverride ] - [-GatewaySiteId ] [-GatewaySiteLbrEnabled ] [-InboundPstnNumberTranslationRules ] [-InboundTeamsNumberTranslationRules ] - [-MaxConcurrentSessions ] [-MediaBypass ] [-MediaRelayRoutingLocationOverride ] [-OutboundPstnNumberTranslationRules ] - [-OutboundTeamsNumberTranslationRules ] [-PidfLoSupported ] [-ProxySbc ] [-SendSipOptions ] [-SipSignalingPort ] [-IPAddressVersion ] - [-WhatIf] [-Confirm] [] +Set-CsOnlinePSTNGateway [[-Identity] ] + [-BypassMode ] + [-Confirm] + [-Description ] + [-Enabled ] + [-FailoverResponseCodes ] + [-FailoverTimeSeconds ] + [-ForwardCallHistory ] + [-ForwardPai ] + [-GatewayLbrEnabledUserOverride ] + [-GatewaySiteId ] + [-GatewaySiteLbrEnabled ] + [-IPAddressVersion ] + [-InboundPstnNumberTranslationRules ] + [-InboundTeamsNumberTranslationRules ] + [-MaxConcurrentSessions ] + [-MediaBypass ] + [-MediaRelayRoutingLocationOverride ] + [-OutboundPstnNumberTranslationRules ] + [-OutboundTeamsNumberTranslationRules ] + [-PidfLoSupported ] + [-ProxySbc ] + [-SendSipOptions ] + [-SipSignalingPort ] + [-WhatIf] + [] ``` ## DESCRIPTION @@ -47,6 +67,50 @@ This example modifies the configuration of an SBC with identity (and FQDN) sbc. ## PARAMETERS +### -Identity +The parameter is mandatory when modifying an existing SBC. + +```yaml +Type: String +Parameter Sets: Identity +Aliases: +Applicable: Microsoft Teams +Required: False +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -BypassMode +Possible values are "None", "Always" and "OnlyForLocalUsers". By setting "Always" mode you indicate that your network is fully routable. If a user usually in site "Seattle", travels to site "Tallinn" and tries to use SBC located in Seattle we will try to deliver the traffic to Seattle assuming that there is connection between Tallinn and Seattle offices. With "OnlyForLocaUsers" you indicate that there is no direct connection between sites. In example above, the traffic will not be send directly from Tallinn to Seattle. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf +Applicable: Microsoft Teams +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Description Free-format string to describe the gateway. @@ -187,29 +251,13 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -Identity -The parameter is mandatory when modifying an existing SBC. - -```yaml -Type: String -Parameter Sets: Identity -Aliases: -Applicable: Microsoft Teams -Required: False -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -MaxConcurrentSessions -Used by the alerting system. When any value is set, the alerting system will generate an alert to the tenant administrator when the number of concurrent session is 90% or higher than this value. If this parameter is not set, the alerts are not generated. However, the monitoring system will report the number of concurrent sessions every 24 hours. +### -InboundTeamsNumberTranslationRules +This parameter assigns an ordered list of Teams translation rules, that apply to Teams numbers on inbound direction. ```yaml -Type: System.Int32 +Type: Object Parameter Sets: (All) Aliases: -Applicable: Microsoft Teams Required: False Position: Named Default value: None @@ -217,57 +265,39 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -MediaBypass -Parameter indicated of the SBC supports Media Bypass and the administrator wants to use it for this SBC. +### -InboundPSTNNumberTranslationRules +Creates an ordered list of Teams translation rules, that apply to PSTN number on inbound direction. ```yaml -Type: Boolean +Type: Object Parameter Sets: (All) Aliases: -Applicable: Microsoft Teams Required: False Position: Named -Default value: $false +Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -MediaRelayRoutingLocationOverride - -Allows selecting path for media manually. Direct Routing assigns a datacenter for media path based on the public IP of the SBC. We always select closest to the SBC datacenter. However, in some cases a public IP from for example a US range can be assigned to an SBC located in Europe. In this case we will be using not optimal media path. We only recommend setting this parameter if the call logs clearly indicate that automatic assignment of the datacenter for media path does not assign the closest to the SBC datacenter. +### -IPAddressVersion +Possible values are "IPv4" and '"Pv6". When "IPv6" is set, the SBC must use IPv6 for both signaling and media. **Note: IPv6 is supported only for non-media bypass scenarios.** ```yaml Type: String Parameter Sets: (All) Aliases: -Applicable: Microsoft Teams Required: False Position: Named -Default value: $false -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -SendSipOptions -Defines if an SBC will or will not send the SIP options. If disabled, the SBC will be excluded from Monitoring and Alerting system. We highly recommend that you enable SIP options. Default value is True. - -```yaml -Type: Boolean -Parameter Sets: (All) -Aliases: -Applicable: Microsoft Teams -Required: False -Position: Named -Default value: $true +Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -SipSignalingPort -Listening port used for communicating with Direct Routing services by using the Transport Layer Security (TLS) protocol. The value must be between 1 and 65535. +### -MaxConcurrentSessions +Used by the alerting system. When any value is set, the alerting system will generate an alert to the tenant administrator when the number of concurrent session is 90% or higher than this value. If this parameter is not set, the alerts are not generated. However, the monitoring system will report the number of concurrent sessions every 24 hours. ```yaml -Type: Int32 +Type: System.Int32 Parameter Sets: (All) Aliases: Applicable: Microsoft Teams @@ -278,44 +308,33 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -BypassMode -Possible values are "None", "Always" and "OnlyForLocalUsers". By setting "Always" mode you indicate that your network is fully routable. If a user usually in site "Seattle", travels to site "Tallinn" and tries to use SBC located in Seattle we will try to deliver the traffic to Seattle assuming that there is connection between Tallinn and Seattle offices. With "OnlyForLocaUsers" you indicate that there is no direct connection between sites. In example above, the traffic will not be send directly from Tallinn to Seattle. +### -MediaBypass +Parameter indicated of the SBC supports Media Bypass and the administrator wants to use it for this SBC. ```yaml -Type: String +Type: Boolean Parameter Sets: (All) Aliases: +Applicable: Microsoft Teams Required: False Position: Named -Default value: None +Default value: $false Accept pipeline input: False Accept wildcard characters: False ``` -### -InboundTeamsNumberTranslationRules -This parameter assigns an ordered list of Teams translation rules, that apply to Teams numbers on inbound direction. - -```yaml -Type: Object -Parameter Sets: (All) -Aliases: -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` +### -MediaRelayRoutingLocationOverride -### -InboundPSTNNumberTranslationRules -Creates an ordered list of Teams translation rules, that apply to PSTN number on inbound direction. +Allows selecting path for media manually. Direct Routing assigns a datacenter for media path based on the public IP of the SBC. We always select closest to the SBC datacenter. However, in some cases a public IP from for example a US range can be assigned to an SBC located in Europe. In this case we will be using not optimal media path. We only recommend setting this parameter if the call logs clearly indicate that automatic assignment of the datacenter for media path does not assign the closest to the SBC datacenter. ```yaml -Type: Object +Type: String Parameter Sets: (All) Aliases: +Applicable: Microsoft Teams Required: False Position: Named -Default value: None +Default value: $false Accept pipeline input: False Accept wildcard characters: False ``` @@ -378,28 +397,28 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -IPAddressVersion -Possible values are "IPv4" and '"Pv6". When "IPv6" is set, the SBC must use IPv6 for both signaling and media. **Note: IPv6 is supported only for non-media bypass scenarios.** - +### -SendSipOptions +Defines if an SBC will or will not send the SIP options. If disabled, the SBC will be excluded from Monitoring and Alerting system. We highly recommend that you enable SIP options. Default value is True. + ```yaml -Type: String +Type: Boolean Parameter Sets: (All) Aliases: +Applicable: Microsoft Teams Required: False Position: Named -Default value: None +Default value: $true Accept pipeline input: False Accept wildcard characters: False ``` -### -WhatIf -Shows what would happen if the cmdlet runs. -The cmdlet is not run. +### -SipSignalingPort +Listening port used for communicating with Direct Routing services by using the Transport Layer Security (TLS) protocol. The value must be between 1 and 65535. ```yaml -Type: SwitchParameter +Type: Int32 Parameter Sets: (All) -Aliases: wi +Aliases: Applicable: Microsoft Teams Required: False Position: Named @@ -408,13 +427,14 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -Confirm -Prompts you for confirmation before running the cmdlet. +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. ```yaml Type: SwitchParameter Parameter Sets: (All) -Aliases: cf +Aliases: wi Applicable: Microsoft Teams Required: False Position: Named