Skip to content

Commit bb04238

Browse files
authored
Merge pull request #12327 from teddygyabaah/patch-5
Update Set-CsOnlinePSTNGateway.md
2 parents 2e3962f + d9333f2 commit bb04238

File tree

1 file changed

+112
-78
lines changed

1 file changed

+112
-78
lines changed

teams/teams-ps/teams/Set-CsOnlinePSTNGateway.md

Lines changed: 112 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -18,12 +18,32 @@ Modifies the previously defined Session Border Controller (SBC) Configuration th
1818
## SYNTAX
1919

2020
```
21-
Set-CsOnlinePSTNGateway [[-Identity] <string>] [-BypassMode <string>] [-Description <string>] [-Enabled <boolean>]
22-
[-FailoverResponseCodes <string>] [-FailoverTimeSeconds <int>] [-ForwardCallHistory <boolean>] [-ForwardPai <boolean>] [-GatewayLbrEnabledUserOverride <boolean>]
23-
[-GatewaySiteId <string>] [-GatewaySiteLbrEnabled <boolean>] [-InboundPstnNumberTranslationRules <Object>] [-InboundTeamsNumberTranslationRules <Object>]
24-
[-MaxConcurrentSessions <int>] [-MediaBypass <boolean>] [-MediaRelayRoutingLocationOverride <string>] [-OutboundPstnNumberTranslationRules <Object>]
25-
[-OutboundTeamsNumberTranslationRules <Object>] [-PidfLoSupported <boolean>] [-ProxySbc <string>] [-SendSipOptions <boolean>] [-SipSignalingPort <int>]
26-
[-WhatIf] [-Confirm] [<CommonParameters>]
21+
Set-CsOnlinePSTNGateway [[-Identity] <string>]
22+
[-BypassMode <string>]
23+
[-Confirm]
24+
[-Description <string>]
25+
[-Enabled <boolean>]
26+
[-FailoverResponseCodes <string>]
27+
[-FailoverTimeSeconds <int>]
28+
[-ForwardCallHistory <boolean>]
29+
[-ForwardPai <boolean>]
30+
[-GatewayLbrEnabledUserOverride <boolean>]
31+
[-GatewaySiteId <string>]
32+
[-GatewaySiteLbrEnabled <boolean>]
33+
[-IPAddressVersion <string>]
34+
[-InboundPstnNumberTranslationRules <Object>]
35+
[-InboundTeamsNumberTranslationRules <Object>]
36+
[-MaxConcurrentSessions <int>]
37+
[-MediaBypass <boolean>]
38+
[-MediaRelayRoutingLocationOverride <string>]
39+
[-OutboundPstnNumberTranslationRules <Object>]
40+
[-OutboundTeamsNumberTranslationRules <Object>]
41+
[-PidfLoSupported <boolean>]
42+
[-ProxySbc <string>]
43+
[-SendSipOptions <boolean>]
44+
[-SipSignalingPort <int>]
45+
[-WhatIf]
46+
[<CommonParameters>]
2747
```
2848

2949
## DESCRIPTION
@@ -47,6 +67,50 @@ This example modifies the configuration of an SBC with identity (and FQDN) sbc.
4767

4868
## PARAMETERS
4969

70+
### -Identity
71+
The parameter is mandatory when modifying an existing SBC.
72+
73+
```yaml
74+
Type: String
75+
Parameter Sets: Identity
76+
Aliases:
77+
Applicable: Microsoft Teams
78+
Required: False
79+
Position: 1
80+
Default value: None
81+
Accept pipeline input: False
82+
Accept wildcard characters: False
83+
```
84+
85+
### -BypassMode
86+
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.
87+
88+
```yaml
89+
Type: String
90+
Parameter Sets: (All)
91+
Aliases:
92+
Required: False
93+
Position: Named
94+
Default value: None
95+
Accept pipeline input: False
96+
Accept wildcard characters: False
97+
```
98+
99+
### -Confirm
100+
Prompts you for confirmation before running the cmdlet.
101+
102+
```yaml
103+
Type: SwitchParameter
104+
Parameter Sets: (All)
105+
Aliases: cf
106+
Applicable: Microsoft Teams
107+
Required: False
108+
Position: Named
109+
Default value: None
110+
Accept pipeline input: False
111+
Accept wildcard characters: False
112+
```
113+
50114
### -Description
51115
Free-format string to describe the gateway.
52116
@@ -187,113 +251,96 @@ Accept pipeline input: False
187251
Accept wildcard characters: False
188252
```
189253
190-
### -Identity
191-
The parameter is mandatory when modifying an existing SBC.
192-
193-
```yaml
194-
Type: String
195-
Parameter Sets: Identity
196-
Aliases:
197-
Applicable: Microsoft Teams
198-
Required: False
199-
Position: 1
200-
Default value: None
201-
Accept pipeline input: False
202-
Accept wildcard characters: False
203-
```
204-
205-
### -MaxConcurrentSessions
206-
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.
254+
### -InboundTeamsNumberTranslationRules
255+
This parameter assigns an ordered list of Teams translation rules, that apply to Teams numbers on inbound direction.
207256
208257
```yaml
209-
Type: System.Int32
258+
Type: Object
210259
Parameter Sets: (All)
211260
Aliases:
212-
Applicable: Microsoft Teams
213261
Required: False
214262
Position: Named
215263
Default value: None
216264
Accept pipeline input: False
217265
Accept wildcard characters: False
218266
```
219267
220-
### -MediaBypass
221-
Parameter indicated of the SBC supports Media Bypass and the administrator wants to use it for this SBC.
268+
### -InboundPSTNNumberTranslationRules
269+
Creates an ordered list of Teams translation rules, that apply to PSTN number on inbound direction.
222270
223271
```yaml
224-
Type: Boolean
272+
Type: Object
225273
Parameter Sets: (All)
226274
Aliases:
227-
Applicable: Microsoft Teams
228275
Required: False
229276
Position: Named
230-
Default value: $false
277+
Default value: None
231278
Accept pipeline input: False
232279
Accept wildcard characters: False
233280
```
234281
235-
### -MediaRelayRoutingLocationOverride
236-
237-
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.
282+
### -IPAddressVersion
283+
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.**
238284
239285
```yaml
240286
Type: String
241287
Parameter Sets: (All)
242288
Aliases:
243-
Applicable: Microsoft Teams
244289
Required: False
245290
Position: Named
246-
Default value: $false
291+
Default value: None
247292
Accept pipeline input: False
248293
Accept wildcard characters: False
249294
```
250295
251-
### -SendSipOptions
252-
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.
296+
### -MaxConcurrentSessions
297+
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.
253298
254299
```yaml
255-
Type: Boolean
300+
Type: System.Int32
256301
Parameter Sets: (All)
257302
Aliases:
258303
Applicable: Microsoft Teams
259304
Required: False
260305
Position: Named
261-
Default value: $true
306+
Default value: None
262307
Accept pipeline input: False
263308
Accept wildcard characters: False
264309
```
265310
266-
### -SipSignalingPort
267-
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.
311+
### -MediaBypass
312+
Parameter indicated of the SBC supports Media Bypass and the administrator wants to use it for this SBC.
268313
269314
```yaml
270-
Type: Int32
315+
Type: Boolean
271316
Parameter Sets: (All)
272317
Aliases:
273318
Applicable: Microsoft Teams
274319
Required: False
275320
Position: Named
276-
Default value: None
321+
Default value: $false
277322
Accept pipeline input: False
278323
Accept wildcard characters: False
279324
```
280325
281-
### -BypassMode
282-
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.
326+
### -MediaRelayRoutingLocationOverride
327+
328+
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.
283329
284330
```yaml
285331
Type: String
286332
Parameter Sets: (All)
287333
Aliases:
334+
Applicable: Microsoft Teams
288335
Required: False
289336
Position: Named
290-
Default value: None
337+
Default value: $false
291338
Accept pipeline input: False
292339
Accept wildcard characters: False
293340
```
294341
295-
### -InboundTeamsNumberTranslationRules
296-
This parameter assigns an ordered list of Teams translation rules, that apply to Teams numbers on inbound direction.
342+
### -OutboundTeamsNumberTranslationRules
343+
Creates an ordered list of Teams translation rules, that apply to Teams Number on outbound direction.
297344
298345
```yaml
299346
Type: Object
@@ -306,8 +353,8 @@ Accept pipeline input: False
306353
Accept wildcard characters: False
307354
```
308355
309-
### -InboundPSTNNumberTranslationRules
310-
Creates an ordered list of Teams translation rules, that apply to PSTN number on inbound direction.
356+
### -OutboundPSTNNumberTranslationRules
357+
Assigns an ordered list of Teams translation rules, that apply to PSTN number on outbound direction.
311358
312359
```yaml
313360
Type: Object
@@ -320,36 +367,38 @@ Accept pipeline input: False
320367
Accept wildcard characters: False
321368
```
322369
323-
### -OutboundTeamsNumberTranslationRules
324-
Creates an ordered list of Teams translation rules, that apply to Teams Number on outbound direction.
370+
### -PidfloSupported
371+
Enables PIDF-LO support on the PSTN Gateway. If turned on the .xml body payload is sent to the SBC with the ___location details of the user.
325372
326373
```yaml
327-
Type: Object
374+
Type: Boolean
328375
Parameter Sets: (All)
329376
Aliases:
377+
Applicable: Microsoft Teams
330378
Required: False
331379
Position: Named
332-
Default value: None
380+
Default value: $false
333381
Accept pipeline input: False
334382
Accept wildcard characters: False
335383
```
336384
337-
### -OutboundPSTNNumberTranslationRules
338-
Assigns an ordered list of Teams translation rules, that apply to PSTN number on outbound direction.
385+
### -ProxySbc
386+
The FQDN of the proxy SBC. Used in Local Media Optimization configurations.
339387
340388
```yaml
341-
Type: Object
389+
Type: String
342390
Parameter Sets: (All)
343391
Aliases:
392+
Applicable: Microsoft Teams
344393
Required: False
345394
Position: Named
346395
Default value: None
347396
Accept pipeline input: False
348397
Accept wildcard characters: False
349398
```
350399
351-
### -PidfloSupported
352-
Enables PIDF-LO support on the PSTN Gateway. If turned on the .xml body payload is sent to the SBC with the ___location details of the user.
400+
### -SendSipOptions
401+
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.
353402
354403
```yaml
355404
Type: Boolean
@@ -358,16 +407,16 @@ Aliases:
358407
Applicable: Microsoft Teams
359408
Required: False
360409
Position: Named
361-
Default value: $false
410+
Default value: $true
362411
Accept pipeline input: False
363412
Accept wildcard characters: False
364413
```
365414
366-
### -ProxySbc
367-
The FQDN of the proxy SBC. Used in Local Media Optimization configurations.
415+
### -SipSignalingPort
416+
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.
368417
369418
```yaml
370-
Type: String
419+
Type: Int32
371420
Parameter Sets: (All)
372421
Aliases:
373422
Applicable: Microsoft Teams
@@ -394,21 +443,6 @@ Accept pipeline input: False
394443
Accept wildcard characters: False
395444
```
396445
397-
### -Confirm
398-
Prompts you for confirmation before running the cmdlet.
399-
400-
```yaml
401-
Type: SwitchParameter
402-
Parameter Sets: (All)
403-
Aliases: cf
404-
Applicable: Microsoft Teams
405-
Required: False
406-
Position: Named
407-
Default value: None
408-
Accept pipeline input: False
409-
Accept wildcard characters: False
410-
```
411-
412446
### CommonParameters
413447
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
414448

0 commit comments

Comments
 (0)