Skip to content

Commit 822cd15

Browse files
Merge pull request #13397 from MicrosoftDocs/main
[AutoPublish] main to live - 02/25 20:11 PST | 02/26 09:41 IST
2 parents ebac025 + 6865bd9 commit 822cd15

8 files changed

Lines changed: 79 additions & 16 deletions

exchange/exchange-ps/ExchangePowerShell/Get-PerimeterConfig.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Get-PerimeterConfig [[-Identity] <OrganizationIdParameter>]
2727
```
2828

2929
## DESCRIPTION
30-
If you have an on-premises email system, you can use the Set-PerimeterConfig cmdlet to add the IP addresses of your gateway servers to cloud-based safelists (also known as whitelists) to make sure that messages sent from your on-premises email system aren't treated as spam.
30+
If you have an on-premises email system, you can use the Set-PerimeterConfig cmdlet to add the IP addresses of your gateway servers to cloud-based safelists to make sure that messages sent from your on-premises email system aren't treated as spam.
3131

3232
## EXAMPLES
3333

exchange/exchange-ps/ExchangePowerShell/Set-PerimeterConfig.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Set-PerimeterConfig [[-Identity] <OrganizationIdParameter>]
3030
```
3131

3232
## DESCRIPTION
33-
If you have an on-premises email system, you can use the Set-PerimeterConfig cmdlet to add the IP addresses of your gateway servers to cloud-based safelists (also known as whitelists) to make sure that messages sent from your on-premises email system aren't treated as spam.
33+
If you have an on-premises email system, you can use the Set-PerimeterConfig cmdlet to add the IP addresses of your gateway servers to cloud-based safelists to make sure that messages sent from your on-premises email system aren't treated as spam.
3434

3535
## EXAMPLES
3636

teams/teams-ps/MicrosoftTeams/New-CsOnlineLisCivicAddress.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -312,7 +312,7 @@ Accept wildcard characters: False
312312
313313
> Applicable: Microsoft Teams
314314
315-
Specifies the angular distance of a place north or south of the earth's equator using the decimal degrees format. Required for all countries except Australia and Japan where it's optional.
315+
Specifies the angular distance of a place north or south of the earth's equator using the decimal degrees format. Required for all countries/regions except Australia and Japan where it's optional.
316316
317317
```yaml
318318
Type: String
@@ -330,7 +330,7 @@ Accept wildcard characters: False
330330
331331
> Applicable: Microsoft Teams
332332
333-
Specifies the angular distance of a place east or west of the meridian at Greenwich, England, using the decimal degrees format. Required for all countries except Australia and Japan where it's optional.
333+
Specifies the angular distance of a place east or west of the meridian at Greenwich, England, using the decimal degrees format. Required for all countries/regions except Australia and Japan where it's optional.
334334
335335
```yaml
336336
Type: String

teams/teams-ps/MicrosoftTeams/New-CsTenantNetworkSubnet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ New-CsTenantNetworkSubnet -MaskBits <int> -SubnetID <string> [-Description <stri
3333
## DESCRIPTION
3434
Each internal subnet may only be associated with one site. Tenant network subnet is used for Location Based Routing. IP subnets at the location where Teams endpoints can connect to the network must be defined and associated to a defined network in order to enforce toll bypass. Multiple subnets may be associated with the same network site, but multiple sites may not be associated with a same subnet. This association of subnets enables Location-Based routing to locate the endpoints geographically to determine if a given PSTN call should be allowed. Both IPv4 and IPv6 subnets are supported. When determining if a Teams endpoint is located at a site an IPv6 address will be checked for a match first.
3535

36-
When the client is sending the network subnet, please make sure we have already whitelisted the IP address by running this command-let, otherwise the request will be rejected. If you are only adding the IPv4 address by running this command-let, but your client are only sending and IPv6 address, it will be rejected.
36+
When the client is sending the network subnet, please make sure we have already safelisted the IP address by running this command-let, otherwise the request will be rejected. If you are only adding the IPv4 address by running this command-let, but your client are only sending and IPv6 address, it will be rejected.
3737

3838
## EXAMPLES
3939

teams/teams-ps/MicrosoftTeams/Set-CsOnlineLisCivicAddress.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,12 @@ Set-CsOnlineLisCivicAddress -CivicAddressId <Guid> [-CompanyName <String>] [-Com
3333
Use the `Set-CsOnlineLisCivicAddress` cmdlet to modify limited fields of an existing civic address.
3434

3535
Editing address using this cmdlet is restricted to the following countries/regions:
36-
Australia, Brazil, Canada, Croatia, Czech Republic, Estonia, Hong Kong, Hungary, Israel, Japan, Latvia, Lithuania, Mexico, New Zealand, Poland, Puerto Rico, Romania, Singapore, South Korea, Slovenia, South Africa, United States.
36+
Australia, Brazil, Canada, Croatia, Czech Republic, Estonia, Hong Kong SAR, Hungary, Israel, Japan, Latvia, Lithuania, Mexico, New Zealand, Poland, Puerto Rico, Romania, Singapore, South Korea, Slovenia, South Africa, United States.
3737

38-
If the user runs this cmdlet on one of the unsupported countries, it may interfere with number assignment and potentially is against regulatory requirements, so public use of the API is limited to the above countries/regions.
38+
If the user runs this cmdlet on one of the unsupported countries/regions, it may interfere with number assignment and potentially is against regulatory requirements, so public use of the API is limited to the above countries/regions.
3939

4040
> [!NOTE]
41-
> This cmdlet is only available for public use with limited countries and certain fields. The remaining countries and fields are for Microsoft internal use only.
41+
> This cmdlet is only available for public use with limited countries/regions and certain fields. The remaining countries/regions and fields are for Microsoft internal use only.
4242
4343
## EXAMPLES
4444

@@ -188,7 +188,7 @@ Accept wildcard characters: False
188188
> Applicable: Microsoft Teams
189189
190190
Specifies a new country or region for the civic address.
191-
For public use, restricted to the following countries:
191+
For public use, restricted to the following countries/regions:
192192
193193
**AU, BR, CA, HR, CZ, EE, HK, HU, IL, JP, LV, LT, MX, NZ, PL, PR, RO, SG, KR, SI, ZA, US**
194194

teams/teams-ps/MicrosoftTeams/Set-CsOnlineVoicemailUserSettings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ The following languages are supported:
260260
- "sl-SI" (Slovenian - Slovenia)
261261
- "sv-SE" (Swedish - Sweden)
262262
- "th-TH" (Thai - Thailand)
263-
- "tr-TR" (Turkish - Turkey)
263+
- "tr-TR" (Turkish - Türkiye)
264264
- "vi-VN" (Vietnamese - Viet Nam)
265265
- "zh-CN" (Chinese - Simplified, PRC)
266266
- "zh-TW" (Chinese - Traditional, Taiwan)

teams/teams-ps/MicrosoftTeams/Set-CsTenantFederationConfiguration.md

Lines changed: 68 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,8 @@ Set-CsTenantFederationConfiguration [-Tenant <Guid>]
3030
[-AllowedDomainsAsAList <List>] [-ExternalAccessWithTrialTenants <ExternalAccessWithTrialTenantsType>]
3131
[-SecurityTeamAllowBlockListDelegation <SecurityTeamAllowBlockListDelegationType>]
3232
[-AllowedTrialTenantDomains <List>]
33+
[-ApplyExternalAccessRestrictionsToChatMembership <Boolean>]
34+
[-ExtendMutualFederationForChatMembership <Boolean>]
3335
[[-Identity] <XdsIdentity>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
3436
```
3537

@@ -38,7 +40,10 @@ Set-CsTenantFederationConfiguration [-Tenant <Guid>]
3840
Set-CsTenantFederationConfiguration [-Tenant <Guid>] [-AllowedDomains <IAllowedDomainsChoice>]
3941
[-BlockedDomains <List>] [-BlockAllSubdomains <Boolean>] [-AllowFederatedUsers <Boolean>]
4042
[-TreatDiscoveredPartnersAsUnverified <Boolean>] [-SharedSipAddressSpace <Boolean>] [-RestrictTeamsConsumerToExternalUserProfiles <Boolean>]
41-
[-AllowedDomainsAsAList <List>] [-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
43+
[-AllowedDomainsAsAList <List>]
44+
[-ApplyExternalAccessRestrictionsToChatMembership <Boolean>]
45+
[-ExtendMutualFederationForChatMembership <Boolean>]
46+
[-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
4247
```
4348

4449
## DESCRIPTION
@@ -189,7 +194,7 @@ $list.add("fabrikam.com")
189194
Set-CsTenantFederationConfiguration -AllowedTrialTenantDomains $list
190195
```
191196

192-
Using the `AllowedTrialTenantDomains` parameter, you can whitelist specific "trial-only" tenant domains, while keeping the `ExternalAccessWithTrialTenants` set to `Blocked`. Example 13 shows how you can set or replace domains in the Allowed Trial Tenant Domains using a List collection object.
197+
Using the `AllowedTrialTenantDomains` parameter, you can safelist specific "trial-only" tenant domains, while keeping the `ExternalAccessWithTrialTenants` set to `Blocked`. Example 13 shows how you can set or replace domains in the Allowed Trial Tenant Domains using a List collection object.
193198
First, a List collection is created and domains are added to it, then, simply include the `AllowedTrialTenantDomains` parameter and set the parameter value to the List object.
194199
When this command completes, the Allowed Trial Tenant Domains list will be replaced with those domains.
195200

@@ -284,9 +289,10 @@ Accept wildcard characters: False
284289
285290
> Applicable: Microsoft Teams
286291
287-
You can whitelist specific "trial-only" tenant domains, while keeping the `ExternalAccessWithTrialTenants` set to `Blocked`. This will allow you to protect your organization against majority of tenants that don't have any paid subscriptions, while still being able to collaborate externally with those trusted trial-tenants in the list.
292+
You can safelist specific "trial-only" tenant domains, while keeping the `ExternalAccessWithTrialTenants` set to `Blocked`. This will allow you to protect your organization against majority of tenants that don't have any paid subscriptions, while still being able to collaborate externally with those trusted trial-tenants in the list.
288293

289294
Note:
295+
290296
- The list supports up to maximum 4k domains.
291297
- If `ExternalAccessWithTrialTenants` is set to `Allowed`, then the `AllowedTrialTenantDomains` list will not be checked.
292298
- Any domain in this list that belongs to a tenant with paid subscriptions will be ignored.
@@ -308,7 +314,7 @@ Accept wildcard characters: False
308314
> Applicable: Microsoft Teams
309315

310316
When set to True (the default value) users will be potentially allowed to communicate with users from other domains.
311-
If this property is set to False then users cannot communicate with users from other domains, regardless of the values assigned to the `AllowedDomains` and `BlockedDomains` properties or any `ExternalAccessPolicy` instances. In effect, the `AllowFederatedUsers` property serves as a master switch that globally enables or disables federation across the Tenant, overridding all other policy settings.
317+
If this property is set to False then users cannot communicate with users from other domains, regardless of the values assigned to the `AllowedDomains` and `BlockedDomains` properties or any `ExternalAccessPolicy` instances. In effect, the `AllowFederatedUsers` property serves as a master switch that globally enables or disables federation across the Tenant, overriding all other policy settings.
312318

313319
To block all domains while selectively allowing specific users to communicate externally via explicit `ExternalAccessPolicy` instances, set `AllowFederatedUsers` to `True` and leave the `AllowedDomains` property empty.
314320

@@ -458,6 +464,63 @@ Default value: None
458464
Accept pipeline input: False
459465
Accept wildcard characters: False
460466
```
467+
### -ApplyExternalAccessRestrictionsToChatMembership
468+
469+
> Applicable: Microsoft Teams
470+
471+
> This parameter is reserved for future use and has no effect at this time.
472+
473+
When set to False (the default value), users in the tenant who have `EnableFederationAccess` set to False in their assigned `ExternalAccessPolicy` can be added to group chats that include external users only when the chat is initiated by a user in the same tenant who has `EnableFederationAccess` set to True.
474+
475+
When set to True, users in the tenant who have `EnableFederationAccess` set to False are blocked from being added to any group chat that includes external users and are removed from existing active group chats that include external users.
476+
477+
The `ApplyExternalAccessRestrictionsToChatMembership` parameter does not affect the behavior set by `CommunicationWithExternalOrgs` parameter of the `ExternalAccessPolicy`.
478+
> [!NOTE]
479+
> This setting only applies to group chats and does not affect a user's ability to join meetings with external users or participate in meeting chats with external users. Refer to [Set-CsExternalAccessPolicy](/powershell/module/microsoftteams/set-csexternalaccesspolicy) for information about `EnableFederationAccess` parameter.
480+
>
481+
> Removal of users only applies to active group chats. An active group chat is defined as a chat in which a message has been sent within the past two hours. Users are removed from inactive group chats only when a new message is sent and the chat becomes active
482+
483+
```yaml
484+
Type: ApplyExternalAccessRestrictionsToChatMembership
485+
Parameter Sets: (All)
486+
Aliases:
487+
488+
Required: False
489+
Position: Named
490+
Default value: False
491+
Accept pipeline input: False
492+
Accept wildcard characters: False
493+
```
494+
### -ExtendMutualFederationForChatMembership
495+
496+
> Applicable: Microsoft Teams
497+
498+
> This parameter is reserved for future use and has no effect at this time.
499+
500+
This parameter specifies whether additional mutual federation requirements are extended across all participants in a group chat. Mutual federation relationships are determined by each user’s effective external access configuration (`AllowedDomains`, `BlockedDomains`, and `ExternalAccessPolicy`). When enabled, this parameter adds participant‑level mutual federation enforcement to group chat.
501+
502+
When set to False (the default value), **only the initiator of the group chat and the user joining or being added are required to have a mutual federation relationship**. Users in the tenant can join or be added to group chats that may include other external participants who are not permitted by the user’s own external access configuration, based on the initiating user’s settings. This behavior applies to group chats initiated by users within the tenant or by external users.
503+
504+
When set to True, **all participants in the group chat must have mutual federation relationships with every other participant in the chat**. Users are blocked from joining or being added to group chats if they do not have mutual federation relationships with all existing participants. These relationships are evaluated continuously for all active chats and participants are automatically removed from existing active group chats when required relationships are no longer valid.
505+
506+
> [!NOTE]
507+
> This setting only applies to group chats and does not affect a user's ability to join meetings with external users or participate in meeting chats with external users. Refer to [Set-CsExternalAccessPolicy](/powershell/module/microsoftteams/set-csexternalaccesspolicy) for information about `EnableFederationAccess` parameter.
508+
>
509+
> Removal of users only applies to active group chats. An active group chat is defined as a chat in which a message has been sent within the past two hours. Users are removed from inactive group chats only when a new message is sent and the chat becomes active.
510+
>
511+
> The user who initiated the chat is never removed from the group chat as a result of this setting.
512+
513+
```yaml
514+
Type: ExtendMutualFederationForChatMembership
515+
Parameter Sets: (All)
516+
Aliases:
517+
518+
Required: False
519+
Position: Named
520+
Default value: False
521+
Accept pipeline input: False
522+
Accept wildcard characters: False
523+
```
461524

462525
### -Force
463526

@@ -482,7 +545,7 @@ Accept wildcard characters: False
482545
> Applicable: Microsoft Teams
483546

484547
Specifies the collection of tenant federation configuration settings to be modified.
485-
Because each tenant is limited to a single, global collection of federation settings there is no need include this parameter when calling the `Set-CsTenantFederationConfiguration` cmdlet.
548+
Because each tenant is limited to a single, global collection of federation settings there is no need to include this parameter when calling the `Set-CsTenantFederationConfiguration` cmdlet.
486549
If you do choose to use the Identity parameter you must also include the Tenant parameter.
487550
For example:
488551

teams/teams-ps/MicrosoftTeams/Set-CsTenantTrustedIPAddress.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ External trusted IPs are the Internet external IPs of the enterprise network and
3636

3737
Both IPv4 and IPv6 trusted IP addresses are supported.
3838

39-
When the client is sending the trusted IP address, please make sure we have already whitelisted the IP address by running this command-let, otherwise the request will be rejected. If you are only adding the IPv4 address by running this command-let, but your client are only sending and IPv6 address, it will be rejected.
39+
When the client is sending the trusted IP address, please make sure we have already safelisted the IP address by running this command-let, otherwise the request will be rejected. If you are only adding the IPv4 address by running this command-let, but your client are only sending and IPv6 address, it will be rejected.
4040

4141
## EXAMPLES
4242

0 commit comments

Comments
 (0)