Merge pull request #11072 from JensTrier/JensUpdate15

Updates to Get/Set-CsPhoneNumberAssignment

Author: tiburd

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

@@ -19,17 +19,20 @@ This cmdlet displays information about one or more phone numbers.
 
 ### Assignment (Default)
 ```powershell
-Get-CsPhoneNumberAssignment [-ActivationState <string>] [-AssignedPstnTargetId <string>] [-CapabilitiesContain <string>] [-CivicAddressId <string>] [-IsoCountryCode <string>] [-LocationId <string>] [-NumberType <string>] [-PstnAssignmentStatus <string>] [-Skip <int>] [-TelephoneNumber <string>] [-TelephoneNumberContain <string>] [-TelephoneNumberGreaterThan <string>] [-TelephoneNumberLessThan <string>] [-TelephoneNumberStartsWith <string>] [-Top <int>] [<CommonParameters>]
+Get-CsPhoneNumberAssignment [-ActivationState <string>] [-AssignedPstnTargetId <string>] [-AssignmentCategory <string>]
+ [-CapabilitiesContain <string>] [-CivicAddressId <string>] [-IsoCountryCode <string>]
+ [-LocationId <string>] [-NumberType <string>] [-PstnAssignmentStatus <string>] [-Skip <int>] [-TelephoneNumber <string>]
+ [-TelephoneNumberContain <string>] [-TelephoneNumberGreaterThan <string>] [-TelephoneNumberLessThan <string>]
+ [-TelephoneNumberStartsWith <string>] [-Top <int>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 This cmdlet displays information about one or more phone numbers. You can filter the phone numbers to return by using different parameters.
 
-Returned results are sorted by TelephoneNumber in ascending order.
+Returned results are sorted by TelephoneNumber in ascending order. 
 
 If you are using both -Skip X and -Top Y for filtering, the returned results will first be skipped by X, and then the top Y results will be returned.
 
-
 ## EXAMPLES
 
 ### Example 1
@@ -41,6 +44,7 @@ TelephoneNumber         : +14025551234
 NumberType              : CallingPlan
 ActivationState         : Activated
 AssignedPstnTargetId    : dc13d97b-7897-494e-bc28-6b469bf7a70e
+AssignmentCategory      : Primary
 Capability              : {UserAssignment}
 City                    : Omaha
 CivicAddressId          : 703b30e5-dbdd-4132-9809-4c6160a6acc7
@@ -64,6 +68,7 @@ TelephoneNumber         : +12065551000;ext=524
 NumberType              : DirectRouting
 ActivationState         : Activated
 AssignedPstnTargetId    : 2713551e-ed63-415d-9175-fc4ff825a0be
+AssignmentCategory      : Primary
 Capability              : {ConferenceAssignment, VoiceApplicationAssignment, UserAssignment}
 City                    : 
 CivicAddressId          : 00000000-0000-0000-0000-000000000000
@@ -152,6 +157,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AssignmentCategory
+This parameter is reserved for internal Microsoft use.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases: 
+Applicable: Microsoft Teams
+
+Required: False
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -CapabilitiesContain
 Filters the returned results based on the capabilities assigned to the phone number. You can specify one or more capabilities delimited by a comma. Supported capabilities are ConferenceAssignment, VoiceApplicationAssignment, UserAssignment, and TeamsPhoneMobile.
 
@@ -370,6 +390,9 @@ The activation state of the telephone number.
 ### AssignedPstnTargetId
 The ID of the object the phone number is assigned to.
 
+### AssignmentCategory
+This parameter is reserved for internal Microsoft use.
+
 ### Capability
 The list of capabilities assigned to the phone number.
 
@@ -412,7 +435,7 @@ The phone number. The number is always displayed with prefixed "+", even if it w
 The object returned is of type SkypeTelephoneNumberMgmtCmdletAcquiredTelephoneNumber.
 
 ## NOTES
-The cmdlet is available in Teams PowerShell module 4.0.0 or later.
+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 cmdlet is only available in commercial and GCC cloud instances.
 

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

@@ -17,9 +17,15 @@ This cmdlet will assign a phone number to a user or a resource account (online a
 
 ## SYNTAX
 
-### Assignment (Default)
+### LocationUpdate (Default)
 ```powershell
-Set-CsPhoneNumberAssignment -Identity <String> -PhoneNumber <String> -PhoneNumberType <String> [-LocationId <String>] [<CommonParameters>]
+Set-CsPhoneNumberAssignment -PhoneNumber <string> -LocationId <string> [<CommonParameters>]
+```
+
+### Assignment
+```powershell
+Set-CsPhoneNumberAssignment -Identity <String> -PhoneNumber <String> -PhoneNumberType <String>
+ [-LocationId <String>] [-AssignmentCategory <string>] [<CommonParameters>]
 ```
 
 ### Attribute
@@ -30,8 +36,7 @@ Set-CsPhoneNumberAssignment -Identity <String> -EnterpriseVoiceEnabled <Boolean>
 ## 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.
 
-You can also assign a location to a phone number when you assign the phone number to a user.
-
+You can also assign a location to a phone number.
 
 To remove a phone number from a user or resource account, use the [Remove-CsPhoneNumberAssignment](Remove-CsPhoneNumberAssignment.md) cmdlet.
 
@@ -93,9 +98,30 @@ foreach ($No in $Numbers) {
 ```
 This example shows how to change the location for unassigned Calling Plan subscriber phone numbers by looping through all the phone numbers, assigning each phone number temporarily with the new location to a user, and then unassigning the phone number again from the user.
 
+### Example 9
+```powershell
+$loc=Get-CsOnlineLisLocation -City Toronto
+Set-CsPhoneNumberAssignment -PhoneNumber +12065551224 -LocationId $loc.LocationId
+```
+This example shows how to set the location on a phone number.
 
 ## PARAMETERS
 
+### -AssignmentCategory
+This parameter is reserved for internal Microsoft use.
+
+```yaml
+Type: System.String
+Parameter Sets: (Assignment)
+Aliases: 
+Applicable: Microsoft Teams
+
+Required: False
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -EnterpriseVoiceEnabled
 Flag indicating if the user or resource account should be EnterpriseVoiceEnabled.
 
@@ -107,7 +133,7 @@ Parameter Sets: (Attribute)
 Aliases: 
 Applicable: Microsoft Teams
 
-Required: False
+Required: True
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
@@ -129,17 +155,18 @@ Accept wildcard characters: False
 ```
 
 ### -LocationId
-The LocationId of the location to assign to the specific user. You can get it using Get-CsOnlineLisLocation. 
+The LocationId of the location to assign to the specific user. You can get it using Get-CsOnlineLisLocation. You can set the location on both assigned and unassigned
+phone numbers.
 
 Removal of location from a phone number is supported for Direct Routing numbers and Operator Connect numbers that are not managed by the Service Desk. 
 If you want to remove the location, use the string value null for LocationId.
 
 ```yaml
 Type: System.String
-Parameter Sets: (Assignment)
+Parameter Sets: (Assignment, LocationUpdate)
 Aliases:
 
-Required: False
+Required: True
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
@@ -154,10 +181,10 @@ Setting a phone number will automatically set EnterpriseVoiceEnabled to True.
 
 ```yaml
 Type: System.String
-Parameter Sets: (Assignment)
+Parameter Sets: (Assignment, LocationUpdate)
 Aliases:
 
-Required: False
+Required: True
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
@@ -171,7 +198,7 @@ Type: System.String
 Parameter Sets: (Assignment)
 Aliases:
 
-Required: False
+Required: True
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
@@ -189,7 +216,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ### System.Object
 
 ## NOTES
-The cmdlet is available in Teams PowerShell module 3.0.0 or later.
+The cmdlet is available in Teams PowerShell module 3.0.0 or later. The parameter set LocationUpdate was introduced in Teams PowerShell module 5.3.1-preview.
 
 The cmdlet is only available in commercial and GCC cloud instances.
 
@@ -198,7 +225,6 @@ If a user or resource account has a phone number set in Active Directory on-prem
 The previous command for assigning phone numbers to users Set-CsUser had the parameter HostedVoiceMail. Setting HostedVoiceMail for Microsoft Teams users is no longer
 necessary and that is why the parameter is not available on Set-CsPhoneNumberAssignment.
 
-
 ## RELATED LINKS
 [Remove-CsPhoneNumberAssignment](Remove-CsPhoneNumberAssignment.md)