Merge pull request #12061 from MicrosoftDocs/main

Publish main to live 08/09/2024, 3:30 PM

Author: garycentric

teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md

@@ -62,6 +62,7 @@ PstnAssignmentStatus    : UserAssigned
 PstnPartnerId           : 7fc2f2eb-89aa-41d7-93de-73d015d22ff0
 PstnPartnerName         : Microsoft
 NumberSource            : Online
+ReverseNumberLookup		: {}
 ```
 This example displays information about the Microsoft Calling Plan subscriber phone number +1 (402) 555-1234. You can see that it is assigned to a user.
 
@@ -89,6 +90,7 @@ PstnAssignmentStatus    : UserAssigned
 PstnPartnerId           : 
 PstnPartnerName         :
 NumberSource            : OnPremises
+ReverseNumberLookup		: {}
 ```
 This example displays information about the Direct Routing phone number +1 (206) 555-1000;ext=524. You can see that it is assigned to a user.
 
@@ -146,6 +148,33 @@ Get-CsPhoneNumberAssignment -AssignedPstnTargetId 'TeamsSharedCallingRoutingPoli
 ```
 This example returns all phone numbers assigned as emergency numbers in the Teams shared calling routing policy instance SC1.
 
+### Example 12
+```powershell
+Get-CsPhoneNumberAssignment -TelephoneNumber "+12065551000;ext=524"
+```
+```output
+TelephoneNumber         : +12065551000;ext=524
+OperatorId              : 83d289bc-a4d3-41e6-8a3f-cff260a3f091
+NumberType              : DirectRouting
+ActivationState         : Activated
+AssignedPstnTargetId    : 2713551e-ed63-415d-9175-fc4ff825a0be
+AssignmentCategory      : Primary
+Capability              : {ConferenceAssignment, VoiceApplicationAssignment, UserAssignment}
+City                    : 
+CivicAddressId          : 00000000-0000-0000-0000-000000000000
+IsoCountryCode          : 
+IsoSubdivision          : 
+LocationId              : 00000000-0000-0000-0000-000000000000
+LocationUpdateSupported : True
+NetworkSiteId           :
+PortInOrderStatus       : 
+PstnAssignmentStatus    : UserAssigned
+PstnPartnerId           : 
+PstnPartnerName         :
+NumberSource            : OnPremises
+ReverseNumberLookup		: {SkipInternalVoip}
+```
+This example displays when SkipInternalVoip option is turned on for a number.
 
 ## PARAMETERS
 
@@ -482,6 +511,9 @@ The phone number. The number is always displayed with prefixed "+", even if it w
 
 The object returned is of type SkypeTelephoneNumberMgmtCmdletAcquiredTelephoneNumber.
 
+### ReverseNumberLookup
+Status of Reverse Number Lookup (RNL). When it is set to SkipInternalVoip, the calls are handled through external PSTN connection instead of internal VoIP lookup. 
+
 ## NOTES
 The cmdlet is available in Teams PowerShell module 4.0.0 or later. The parameter AssignmentCategory was introduced in Teams PowerShell module 5.3.1-preview. The parameter NetworkSiteId was introduced in Teams PowerShell module 5.5.0. The output parameter NumberSource was introduced in Teams PowerShell module 5.7.0.
 

teams/teams-ps/teams/Get-CsTeamsAcsFederationConfiguration.md

@@ -28,7 +28,7 @@ Federation between Teams and Azure Communication Services (ACS) allows users of
 
 This cmdlet is used retrieve the Teams and ACS federation configuration for a Teams tenant.
 
-You must be a Teams service admin, a Teams communication admin, or Global Administrator for your organization to run the cmdlet.
+You must be a Teams service admin or a Teams communication admin for your organization to run the cmdlet.
 
 ## Examples
 

teams/teams-ps/teams/Get-CsTeamsEducationConfiguration.md

@@ -24,7 +24,7 @@ Get-CsTeamsEducationConfiguration
 
 This cmdlet is used to retrieve the organization-wide education configuration for Teams which contains settings that are applicable to education organizations.
 
-You must be a Teams Service Administrator or a Global Administrator for your organization to run the cmdlet.
+You must be a Teams Service Administrator for your organization to run the cmdlet.
 
 ## Examples
 

teams/teams-ps/teams/Get-CsTeamsSipDevicesConfiguration.md

@@ -24,7 +24,7 @@ Get-CsTeamsSipDevicesConfiguration
 
 This cmdlet is used to retrieve the organization-wide Teams SIP devices configuration which contains settings that are applicable to SIP devices connected to Teams using Teams Sip Gateway.
 
-To execute the cmdlet, you need to hold a role within your organization such as Global Administrator, Global Reader, Teams Administrator, or Teams Communication Administrator.
+To execute the cmdlet, you need to hold a role within your organization such as Global Reader, Teams Administrator, or Teams Communication Administrator.
 
 ## Examples
 

teams/teams-ps/teams/New-CsBatchPolicyAssignmentOperation.md

@@ -30,7 +30,7 @@ Users can be specified by their object ID (guid) or by their SIP address (user@c
 
 A batch may contain up to 5,000 users. If a batch includes duplicate users, the duplicates will be removed from the batch before processing and status will only be provided for the unique users remaining in the batch. For best results, do not submit more than a few batches at a time.  Allow batches to complete processing before submitting more batches.
 
-You must be a Teams service admin, a Teams communication admin, or Global Administrator to run the cmdlet.
+You must be a Teams service admin or a Teams communication admin to run the cmdlet.
 
 Batch policy assignment is currently limited to the following policy types:
 CallingLineIdentity, ExternalAccessPolicy, OnlineVoiceRoutingPolicy, TeamsAppSetupPolicy, TeamsAppPermissionPolicy, TeamsCallingPolicy, TeamsCallParkPolicy, TeamsChannelsPolicy, TeamsEducationAssignmentsAppPolicy, TeamsEmergencyCallingPolicy, TeamsMeetingBroadcastPolicy, TeamsEmergencyCallRoutingPolicy, TeamsMeetingPolicy, TeamsMessagingPolicy, TeamsTemplatePermissionPolicy, TeamsUpdateManagementPolicy, TeamsUpgradePolicy,  TeamsVerticalPackagePolicy, TeamsVideoInteropServicePolicy, TenantDialPlan

teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md

@@ -38,6 +38,11 @@ Set-CsPhoneNumberAssignment -Identity <String> -PhoneNumber <String> -PhoneNumbe
 Set-CsPhoneNumberAssignment -Identity <String> -EnterpriseVoiceEnabled <Boolean> [<CommonParameters>]
 ```
 
+### ReverseNumberLookup
+```powershell
+Set-CsPhoneNumberAssignment -PhoneNumber <string> -ReverseNumberLookup <string> [<CommonParameters>]
+```
+
 ## DESCRIPTION
 This cmdlet assigns a phone number to a user or resource account. When you assign a phone number the EnterpriseVoiceEnabled flag is automatically set to True.
 
@@ -132,6 +137,12 @@ Write-Host (Get-CsPhoneNumberAssignment -LocationId $NewLocationId).Count number
 ```
 This Example shows how to update the LocationID from an old location to a new location for a set of phone numbers.
 
+### Example 11
+```powershell
+Set-CsPhoneNumberAssignment -Identity [email protected] -PhoneNumber +12065551226 -ReverseNumberLookup 'SkipInternalVoip'
+```
+This example shows how to turn off reverse number lookup (RNL) on a phone number. When RNL is set to 'SkipInternalVoip', an internal call to this phone number will not attempt to pass through internal VoIP via reverse number lookup in Microsoft Teams. Instead the call will be established through external PSTN connectivity directly. 
+
 
 ## PARAMETERS
 

teams/teams-ps/teams/Set-CsTeamsAcsFederationConfiguration.md

@@ -34,7 +34,7 @@ Federation between Teams and Azure Communication Services (ACS) allows external
 
 This cmdlet is used to enable or disable Teams and ACS federation for a Teams tenant, and to specify which ACS resources can connect to Teams. Only listed ACS resources can be allowed.
 
-You must be a Teams service admin, a Teams communication admin, or Global Administrator for your organization to run the cmdlet.
+You must be a Teams service admin or a Teams communication admin for your organization to run the cmdlet.
 
 ## EXAMPLES
 

teams/teams-ps/teams/Set-CsTeamsEducationConfiguration.md

@@ -29,7 +29,7 @@ Set-CsTeamsEducationConfiguration
 
 This cmdlet is used to manage the organization-wide education configuration for Teams which contains settings that are applicable to education organizations.
 
-You must be a Teams Service Administrator or a Global Administrator for your organization to run the cmdlet.
+You must be a Teams Service Administrator for your organization to run the cmdlet.
 
 ## EXAMPLES
 

teams/teams-ps/teams/Set-CsTeamsSipDevicesConfiguration.md

@@ -28,7 +28,7 @@ Set-CsTeamsSipDevicesConfiguration
 
 This cmdlet is used to manage the organization-wide Teams SIP devices configuration which contains settings that are applicable to SIP devices connected to Teams using Teams Sip Gateway.
 
-To execute the cmdlet, you need to hold a role within your organization such as Global Administrator, Teams Administrator, or Teams Communication Administrator.
+To execute the cmdlet, you need to hold a role within your organization such as Teams Administrator or Teams Communication Administrator.
 
 ## EXAMPLES