updating help files and tests

Author: Bhavin Shah

src/Support/Support.Test/ScenarioTests/SupportTicketTests.cs

@@ -139,7 +139,7 @@ public void UpdateAzSupportTicketNameParameterSetUpdateSeverity()
         [Trait(Category.AcceptanceType, Category.CheckIn)]
         public void UpdateAzSupportTicketParentObjectParameterSetUpdateStatus()
         {
-            TestController.NewInstance.RunPowerShellTest(_logger, "Update-AzSupportTicketParentObjectParameterSetUpdateSeverity");
+            TestController.NewInstance.RunPowerShellTest(_logger, "Update-AzSupportTicketParentObjectParameterSetUpdateStatus");
         }
 
         [Fact]

src/Support/Support.Test/ScenarioTests/SupportTicketTests.ps1

@@ -323,7 +323,7 @@ function Update-AzSupportTicketParentObjectParameterSetUpdateStatus
 	Assert-IsInstance $updateTicket $cmdletReturnType
 	Assert-PropertiesCount $updateTicket $propertiesCount
 	Assert-IsInstance $updateTicket.Name String
-	Assert-AreEqual "closed" $updateTicket.Severity.ToLower()
+	Assert-AreEqual "closed" $updateTicket.Status.ToLower()
 }
 
 <#

src/Support/Support.Test/SessionRecords/Microsoft.Azure.Commands.Support.Test.ScenarioTests.SupportTicketTests/UpdateAzSupportTicketNameParameterSetUpdateStatus.json

@@ -12,7 +12,7 @@
 # RootModule = ''
 
 # Version number of this module.
-ModuleVersion = '0.1.0'
+ModuleVersion = '1.0.0'
 
 # Supported PSEditions
 CompatiblePSEditions = 'Core', 'Desktop'
@@ -110,15 +110,7 @@ PrivateData = @{
         # IconUri = ''
 
         # ReleaseNotes of this module
-        ReleaseNotes = '* Preview release of ''Az.Support'' module. Added following cmdlets for creation and management of support tickets.
-    - Get-AzSupportService
-    - Get-AzSupportProblemClassification
-    - New-AzSupportContactProfileObject
-    - New-AzSupportTicket
-    - Get-AzSupportTicket
-    - Update-AzSupportTicket
-    - New-AzSupportTicketCommunication
-    - Get-AzSupportTicketCommunication'
+        ReleaseNotes = '* Stable release of ''Az.Support'' module. A support ticket can now be closed using Update-AzSupportTicket cmdlet. A new severity HighestCriticalImpact was added that is available to certain customers. Get-AzSupportService returns one or more ARM ResourceTypes that the service is responsible for. ProductionOutage property was removed from support ticket details object.'
 
         # Prerelease string of this module
         # Prerelease = ''

src/Support/Support.Test/SessionRecords/Microsoft.Azure.Commands.Support.Test.ScenarioTests.SupportTicketTests/UpdateAzSupportTicketParentObjectParameterSetUpdateStatus.json

@@ -22,6 +22,7 @@
 using Microsoft.WindowsAzure.Commands.Utilities.Common;
 using System.Linq;
 using System.Management.Automation;
+using Status = Microsoft.Azure.Commands.Support.Models.Status;
 
 namespace Microsoft.Azure.Commands.Support.SupportTickets
 {
@@ -42,7 +43,7 @@ public class UpdateAzSupportTicket : AzSupportCmdletBase
         public Severity Severity { get; set; }
 
         [Parameter(Mandatory = false, HelpMessage = "Update Status of SupportTicket.")]
-        public Models.Status Status { get; set; }
+        public Status Status { get; set; }
 
         [Parameter(Mandatory = true, ParameterSetName = UpdateByNameWithContactObjectParameterSet, HelpMessage = "Update Contact details on SupportTicket.")]
         [Parameter(Mandatory = true, ParameterSetName = UpdateByInputObjectWithContactObjectParameterSet, HelpMessage = "Update Contact details on SupportTicket.")]
@@ -128,18 +129,29 @@ public override void ExecuteCmdlet()
                 }
                 else
                 {
-                    updateContactProfile = new UpdateContactProfile
+                    if (this.IsParameterBound(c => c.CustomerFirstName) ||
+                        this.IsParameterBound(c => c.CustomerLastName) ||
+                        this.IsParameterBound(c => c.CustomerPrimaryEmailAddress) ||
+                        this.IsParameterBound(c => c.CustomerPreferredTimeZone) ||
+                        this.IsParameterBound(c => c.CustomerPreferredSupportLanguage) ||
+                        this.IsParameterBound(c => c.CustomerPhoneNumber) ||
+                        this.IsParameterBound(c => c.AdditionalEmailAddress) ||
+                        this.IsParameterBound(c => c.CustomerCountry) ||
+                        this.IsParameterBound(c => c.PreferredContactMethod))
                     {
-                        FirstName = this.IsParameterBound(c => c.CustomerFirstName) ? this.CustomerFirstName : null,
-                        LastName = this.IsParameterBound(c => c.CustomerLastName) ? this.CustomerLastName : null,
-                        PrimaryEmailAddress = this.IsParameterBound(c => c.CustomerPrimaryEmailAddress) ? this.CustomerPrimaryEmailAddress : null,
-                        PreferredTimeZone = this.IsParameterBound(c => c.CustomerPreferredTimeZone) ? this.CustomerPreferredTimeZone : null,
-                        PreferredSupportLanguage = this.IsParameterBound(c => c.CustomerPreferredSupportLanguage) ? this.CustomerPreferredSupportLanguage : null,
-                        PhoneNumber = this.IsParameterBound(c => c.CustomerPhoneNumber) ? this.CustomerPhoneNumber : null,
-                        AdditionalEmailAddresses = this.IsParameterBound(c => c.AdditionalEmailAddress) ? this.AdditionalEmailAddress.ToList() : null,
-                        Country = this.IsParameterBound(c => c.CustomerCountry) ? this.CustomerCountry : null,
-                        PreferredContactMethod = this.IsParameterBound(c => c.PreferredContactMethod) ? this.PreferredContactMethod.ToString() : null
-                    };
+                        updateContactProfile = new UpdateContactProfile
+                        {
+                            FirstName = this.IsParameterBound(c => c.CustomerFirstName) ? this.CustomerFirstName : null,
+                            LastName = this.IsParameterBound(c => c.CustomerLastName) ? this.CustomerLastName : null,
+                            PrimaryEmailAddress = this.IsParameterBound(c => c.CustomerPrimaryEmailAddress) ? this.CustomerPrimaryEmailAddress : null,
+                            PreferredTimeZone = this.IsParameterBound(c => c.CustomerPreferredTimeZone) ? this.CustomerPreferredTimeZone : null,
+                            PreferredSupportLanguage = this.IsParameterBound(c => c.CustomerPreferredSupportLanguage) ? this.CustomerPreferredSupportLanguage : null,
+                            PhoneNumber = this.IsParameterBound(c => c.CustomerPhoneNumber) ? this.CustomerPhoneNumber : null,
+                            AdditionalEmailAddresses = this.IsParameterBound(c => c.AdditionalEmailAddress) ? this.AdditionalEmailAddress.ToList() : null,
+                            Country = this.IsParameterBound(c => c.CustomerCountry) ? this.CustomerCountry : null,
+                            PreferredContactMethod = this.IsParameterBound(c => c.PreferredContactMethod) ? this.PreferredContactMethod.ToString() : null
+                        };
+                    }
                 }
 
                 updateSupportTicket.ContactDetails = updateContactProfile;

src/Support/Support/Az.Support.psd1

@@ -27,7 +27,7 @@ Creates a new Azure support ticket. This operation is modeled on the behavior of
 Gets the list of support tickets. You can get full support ticket details by ticket name or filter the support tickets by *Status* or *CreatedDate*.
 
 ### [Update-AzSupportTicket](Update-AzSupportTicket.md)
-Update a support ticket's severity or customer contact details.
+Update a support ticket's severity, status or customer contact details.
 
 ### [Get-AzSupportTicketCommunication](Get-AzSupportTicketCommunication.md)
 Gets communications for a support ticket. You can also filter support ticket communications by *CreatedDate* or *CommunicationType*. 

src/Support/Support/SupportTickets/UpdateAzSupportTicket.cs

@@ -23,7 +23,7 @@ Get-AzSupportService -Id <String> [-DefaultProfile <IAzureContextContainer>] [<C
 ```
 
 ## DESCRIPTION
-Gets the current list of Azure services for which support is available. Each Azure service has its own set of categories called problem classification. Get the current list of problem classification for a service using Get-AzSupportProblemClassification. You can use the service and problem classification GUID to create a new support ticket using New-AzSupportTicket.
+Gets the current list of Azure services for which support is available. Each Azure service may contain one of more ARM ResouceTypes that it is responsible for, that you can use to identify the service when creating a technical support ticket for an ARM resource. Each Azure service has its own set of categories called problem classification. Get the current list of problem classification for a service using Get-AzSupportProblemClassification. You can use the service and problem classification GUID to create a new support ticket using New-AzSupportTicket.
 
 Always use the service and problem classification GUIDs obtained programmatically. This practice ensures that you have the most recent set of service and problem classification GUIDs for support ticket creation.
 

src/Support/Support/help/Az.Support.md

@@ -575,7 +575,7 @@ This indicates the urgency of the case, which in turn determines the response ti
 Type: Microsoft.Azure.Commands.Support.Models.Severity
 Parameter Sets: (All)
 Aliases:
-Accepted values: Minimal, Moderate, Critical
+Accepted values: Minimal, Moderate, Critical, HighestCriticalImpact
 
 Required: True
 Position: Named

src/Support/Support/help/Get-AzSupportService.md

@@ -14,7 +14,7 @@ Updates support ticket.
 
 ### UpdateByNameWithContactDetailParameterSet (Default)
 ```
-Update-AzSupportTicket -Name <String> [-Severity <Severity>] [-CustomerFirstName <String>]
+Update-AzSupportTicket -Name <String> [-Severity <Severity>] [-Status <Status>] [-CustomerFirstName <String>]
  [-CustomerLastName <String>] [-PreferredContactMethod <ContactMethod>] [-CustomerPrimaryEmailAddress <String>]
  [-AdditionalEmailAddress <String[]>] [-CustomerPhoneNumber <String>] [-CustomerPreferredTimeZone <String>]
  [-CustomerCountry <String>] [-CustomerPreferredSupportLanguage <String>]
@@ -23,13 +23,13 @@ Update-AzSupportTicket -Name <String> [-Severity <Severity>] [-CustomerFirstName
 
 ### UpdateByNameWithContactObjectParameterSet
 ```
-Update-AzSupportTicket -Name <String> [-Severity <Severity>] -CustomerContactDetail <PSContactProfile>
+Update-AzSupportTicket -Name <String> [-Severity <Severity>] [-Status <Status>] -CustomerContactDetail <PSContactProfile>
  [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### UpdateByInputObjectWithContactDetailParameterSet
 ```
-Update-AzSupportTicket -InputObject <PSSupportTicket> [-Severity <Severity>] [-CustomerFirstName <String>]
+Update-AzSupportTicket -InputObject <PSSupportTicket> [-Severity <Severity>] [-Status <Status>] [-CustomerFirstName <String>]
  [-CustomerLastName <String>] [-PreferredContactMethod <ContactMethod>] [-CustomerPrimaryEmailAddress <String>]
  [-AdditionalEmailAddress <String[]>] [-CustomerPhoneNumber <String>] [-CustomerPreferredTimeZone <String>]
  [-CustomerCountry <String>] [-CustomerPreferredSupportLanguage <String>]
@@ -38,13 +38,13 @@ Update-AzSupportTicket -InputObject <PSSupportTicket> [-Severity <Severity>] [-C
 
 ### UpdateByInputObjectWithContactObjectParameterSet
 ```
-Update-AzSupportTicket -InputObject <PSSupportTicket> [-Severity <Severity>]
+Update-AzSupportTicket -InputObject <PSSupportTicket> [-Severity <Severity>] [-Status <Status>]
  -CustomerContactDetail <PSContactProfile> [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm]
  [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Use this cmdlet to update a support ticket's severity level or customer contact details. Note that updating a support ticket's severity level is not allowed when the ticket is assigned to a support engineer. If you wish to update the severity level after ticket assignment, contact the support engineer by sending a communication on the ticket.
+Use this cmdlet to update a support ticket's severity level, status or customer contact details. Note that updating a support ticket's severity level or status is not allowed when the ticket is assigned to a support engineer. If you wish to update the severity level or status after ticket assignment, contact the support engineer by sending a communication on the ticket.
 
 ## EXAMPLES
 
@@ -57,7 +57,16 @@ Name  Title                        SupportTicketId Severity ServiceDisplayName
 test1 test title1                  150010521000317 Moderate Virtual Machine running Linux Open   2/5/2020 1:33:53 AM
 ```
 
-### Example 2: Update contact details of support ticket by specify contact object.
+### Example 2: Update status of support ticket.
+```powershell
+PS C:\> Update-AzSupportTicket -Name "test1" -Status "Closed"
+
+Name  Title                        SupportTicketId Severity ServiceDisplayName            Status CreatedDate
+----  -----                        --------------- -------- ------------------            ------ -----------
+test1 test title1                  150010521000317 Moderate Virtual Machine running Linux Closed   2/5/2020 1:33:53 AM
+```
+
+### Example 3: Update contact details of support ticket by specify contact object.
 ```powershell
 PS C:\> $contactDetail = new-object Microsoft.Azure.Commands.Support.Models.PSContactProfile
 PS C:\> $contactDetail.FirstName = "first name updated"
@@ -69,7 +78,7 @@ Name  Title                        SupportTicketId Severity ServiceDisplayName
 test1 test title1                  150010521000317 Moderate Virtual Machine running Linux Open   2/5/2020 1:33:53 AM
 ```
 
-### Example 3: Update severity of support ticket by piping support ticket object.
+### Example 4: Update severity of support ticket by piping support ticket object.
 ```powershell
 PS C:\> Get-AzSupportTicket -Name "test1" | Update-AzSupportTicket -Severity "moderate"
 
@@ -78,7 +87,7 @@ Name  Title                        SupportTicketId Severity ServiceDisplayName
 test1 test title1                  150010521000317 Moderate Virtual Machine running Linux Open   2/5/2020 1:33:53 AM
 ```
 
-### Example 4: Update contact details of support ticket by specifying individual contact parameters.
+### Example 5: Update contact details of support ticket by specifying individual contact parameters.
 ```powershell
 PS C:\> Update-AzSupportTicket -Name "test1" -CustomerFirstName "first name updated" -CustomerLastName "last name updated" -AdditionalEmailAddress @("[email protected]") 
 
@@ -87,6 +96,15 @@ Name  Title                        SupportTicketId Severity ServiceDisplayName
 test1 test title1                  150010521000317 Moderate Virtual Machine running Linux Open   2/5/2020 1:33:53 AM
 ```
 
+### Example 6: Update status of support ticket by piping support ticket object.
+```powershell
+PS C:\> Get-AzSupportTicket -Name "test1" | Update-AzSupportTicket -Status "Closed"
+
+Name  Title                        SupportTicketId Severity ServiceDisplayName            Status CreatedDate
+----  -----                        --------------- -------- ------------------            ------ -----------
+test1 test title1                  150010521000317 Moderate Virtual Machine running Linux Closed   2/5/2020 1:33:53 AM
+```
+
 ## PARAMETERS
 
 ### -AdditionalEmailAddress
@@ -297,7 +315,23 @@ Update Severity of SupportTicket.
 Type: Microsoft.Azure.Commands.Support.Models.Severity
 Parameter Sets: (All)
 Aliases:
-Accepted values: Minimal, Moderate, Critical
+Accepted values: Minimal, Moderate, Critical, HighestCriticalImpact
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Status
+Update Status of SupportTicket.
+
+```yaml
+Type: Microsoft.Azure.Commands.Support.Models.Status
+Parameter Sets: (All)
+Aliases:
+Accepted values: Open, Closed
 
 Required: False
 Position: Named