From 552be2177e32626eadda02aa7ffdfaece15e0837 Mon Sep 17 00:00:00 2001 From: Bhavin Shah Date: Mon, 22 Jun 2020 22:18:29 -0700 Subject: [PATCH 1/3] doc update adding example --- src/Support/Support/help/Get-AzSupportTicket.md | 4 ++-- src/Support/Support/help/New-AzSupportTicket.md | 15 ++++++++++++--- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/src/Support/Support/help/Get-AzSupportTicket.md b/src/Support/Support/help/Get-AzSupportTicket.md index d892e9ceaf9c..251d19b26f9b 100644 --- a/src/Support/Support/help/Get-AzSupportTicket.md +++ b/src/Support/Support/help/Get-AzSupportTicket.md @@ -71,7 +71,7 @@ Name Title SupportTicketId Severity ServiceDisplayName test1 test title1 150010521000317 Minimal Virtual Machine running Linux Closed 2/5/2020 1:33:53 AM ``` -### Example 3: Get first 2 support tickets filtered by status +### Example 4: Get first 2 support tickets filtered by status ```powershell PS C:\> Get-AzSupportTicket -Filter "Status eq 'Closed'" -First 2 @@ -81,7 +81,7 @@ test1 test title1 150010521000317 Minimal Virtual Machine runn test2 test title2 150010521000318 Minimal Billing Closed 2/5/2020 1:33:53 AM ``` -### Example 3: Get all support tickets that are in Open state and created after Dec 20th, 2019 +### Example 5: Get all support tickets that are in Open state and created after Dec 20th, 2019 ```powershell PS C:\> Get-AzSupportTicket -Filter "Status eq 'Open' and CreatedDate gt 2019-12-20" diff --git a/src/Support/Support/help/New-AzSupportTicket.md b/src/Support/Support/help/New-AzSupportTicket.md index 233f1a1f9d2b..7a6210e0d07b 100644 --- a/src/Support/Support/help/New-AzSupportTicket.md +++ b/src/Support/Support/help/New-AzSupportTicket.md @@ -241,7 +241,16 @@ Name Title SupportTicketId Severity ServiceDisplayName St test1 Test 150010521000317 Minimal Service and subscription limits (quotas) Open 2/5/2020 1:33:53 AM ``` -### Example 15: Create a support ticket by specifying individual customer contact parameters instead of CustomerContactDetail object. +### Example 15: Create a quota support ticket to increase quota for Azure SQL Managed Instance. Use Get-AzSupportService and Get-AzSupportProblemClassification to retrieve correct GUIDs for Quota SQL Managed Instance service problem classification. +```powershell +PS C:\> New-AzSupportTicket -Name "test1" -Title "Test" -Description "Test" -Severity "minimal" -ProblemClassificationId "/providers/Microsoft.Support/services/{quota_service_guid}/problemClassifications/{sql_managed_instance_problemClassification_guid}" -QuotaTicketDetail @{QuotaChangeRequestVersion = "1.0" ; QuotaChangeRequestSubType = "SQLMI" ; QuotaChangeRequests = (@{Region = "westus"; Payload = "{`"NewLimit`":200,`"Type`":`"vCore`" }"}, @{Region = "westus"; Payload = "{`"NewLimit`":200,`"Type`":`"Subnet`" }"})} -CustomerContactDetail @{FirstName = "first" ; LastName = "last" ; PreferredTimeZone = "pacific standard time" ; PreferredSupportLanguage = "en-us" ; Country = "USA" ; PreferredContactMethod = "Email" ; PrimaryEmailAddress = "user@contoso.com"} + +Name Title SupportTicketId Severity ServiceDisplayName Status CreatedDate +---- ----- --------------- -------- ------------------ ------ ----------- +test1 Test 150010521000317 Minimal Service and subscription limits (quotas) Open 2/5/2020 1:33:53 AM +``` + +### Example 16: Create a support ticket by specifying individual customer contact parameters instead of CustomerContactDetail object. ```powershell PS C:\> New-AzSupportTicket -Name "test1" -Title "Test" -Description "Test" -Severity "minimal" -ProblemClassificationId "/providers/Microsoft.Support/services/{billing_service_guid}/problemClassifications/{problemClassification_guid}" -CustomerFirstName "first" -CustomerLastName "last" -CustomerPreferredTimeZone "pacific standard time" -CustomerPreferredSupportLanguage "en-us" -CustomerCountry = "USA" -PreferredContactMethod "Email" -CustomerPrimaryEmailAddress "user@contoso.com" @@ -250,7 +259,7 @@ Name Title SupportTicketId Severity ServiceDisplayName Status CreatedDate test1 Test 150010521000317 Minimal Billing Open 2/5/2020 1:33:53 AM ``` -### Example 16: Create a support ticket with request for 24 x 7 response from Azure. +### Example 17: Create a support ticket with request for 24 x 7 response from Azure. ```powershell PS C:\> New-AzSupportTicket -Name "test1" -Title "Test" -Description "Test" -Severity "critical" -ProblemClassificationId "/providers/Microsoft.Support/services/{billing_service_guid}/problemClassifications/{problemClassification_guid}" -CustomerFirstName "first" -CustomerLastName "last" -CustomerPreferredTimeZone "pacific standard time" -CustomerPreferredSupportLanguage "en-us" -CustomerCountry = "USA" -PreferredContactMethod "Email" -CustomerPrimaryEmailAddress "user@contoso.com" -Require24X7Response @@ -259,7 +268,7 @@ Name Title SupportTicketId Severity ServiceDisplayName Status CreatedDate test1 Test 150010521000317 Critical Billing Open 2/5/2020 1:33:53 AM ``` -### Example 17: Create a support ticket on behalf of your customer if you are a Cloud Solution Provider (CSP). CSP should first login into their tenant, and then login into customer's tenant as shown in the example below. They must then use -CSPHomeTenantId parameter to specify their home tenant id at the time of creating a support ticket. +### Example 18: Create a support ticket on behalf of your customer if you are a Cloud Solution Provider (CSP). CSP should first login into their tenant, and then login into customer's tenant as shown in the example below. They must then use -CSPHomeTenantId parameter to specify their home tenant id at the time of creating a support ticket. ```powershell PS C:\> Login-AzAccount From 009e4b69ce70edbb2e28c3fb1a9addece84ac4ae Mon Sep 17 00:00:00 2001 From: Bhavin Shah Date: Mon, 22 Jun 2020 22:18:29 -0700 Subject: [PATCH 2/3] doc update adding example --- src/Support/Support/Az.Support.psd1 | 2 +- src/Support/Support/ChangeLog.md | 3 +++ src/Support/Support/help/Get-AzSupportTicket.md | 4 ++-- src/Support/Support/help/New-AzSupportTicket.md | 15 ++++++++++++--- 4 files changed, 18 insertions(+), 6 deletions(-) diff --git a/src/Support/Support/Az.Support.psd1 b/src/Support/Support/Az.Support.psd1 index 9d54f573fbf7..fb1bcb523cd4 100644 --- a/src/Support/Support/Az.Support.psd1 +++ b/src/Support/Support/Az.Support.psd1 @@ -12,7 +12,7 @@ # RootModule = '' # Version number of this module. -ModuleVersion = '1.0.0' +ModuleVersion = '1.0.1' # Supported PSEditions CompatiblePSEditions = 'Core', 'Desktop' diff --git a/src/Support/Support/ChangeLog.md b/src/Support/Support/ChangeLog.md index 56f9adb57ef0..f1557437b4fd 100644 --- a/src/Support/Support/ChangeLog.md +++ b/src/Support/Support/ChangeLog.md @@ -20,6 +20,9 @@ ## Upcoming Release +## Version 1.0.1 +* Documentation update of `Az.Support` module + ## Version 1.0.0 * General availability of `Az.Support` module diff --git a/src/Support/Support/help/Get-AzSupportTicket.md b/src/Support/Support/help/Get-AzSupportTicket.md index d892e9ceaf9c..251d19b26f9b 100644 --- a/src/Support/Support/help/Get-AzSupportTicket.md +++ b/src/Support/Support/help/Get-AzSupportTicket.md @@ -71,7 +71,7 @@ Name Title SupportTicketId Severity ServiceDisplayName test1 test title1 150010521000317 Minimal Virtual Machine running Linux Closed 2/5/2020 1:33:53 AM ``` -### Example 3: Get first 2 support tickets filtered by status +### Example 4: Get first 2 support tickets filtered by status ```powershell PS C:\> Get-AzSupportTicket -Filter "Status eq 'Closed'" -First 2 @@ -81,7 +81,7 @@ test1 test title1 150010521000317 Minimal Virtual Machine runn test2 test title2 150010521000318 Minimal Billing Closed 2/5/2020 1:33:53 AM ``` -### Example 3: Get all support tickets that are in Open state and created after Dec 20th, 2019 +### Example 5: Get all support tickets that are in Open state and created after Dec 20th, 2019 ```powershell PS C:\> Get-AzSupportTicket -Filter "Status eq 'Open' and CreatedDate gt 2019-12-20" diff --git a/src/Support/Support/help/New-AzSupportTicket.md b/src/Support/Support/help/New-AzSupportTicket.md index 233f1a1f9d2b..7a6210e0d07b 100644 --- a/src/Support/Support/help/New-AzSupportTicket.md +++ b/src/Support/Support/help/New-AzSupportTicket.md @@ -241,7 +241,16 @@ Name Title SupportTicketId Severity ServiceDisplayName St test1 Test 150010521000317 Minimal Service and subscription limits (quotas) Open 2/5/2020 1:33:53 AM ``` -### Example 15: Create a support ticket by specifying individual customer contact parameters instead of CustomerContactDetail object. +### Example 15: Create a quota support ticket to increase quota for Azure SQL Managed Instance. Use Get-AzSupportService and Get-AzSupportProblemClassification to retrieve correct GUIDs for Quota SQL Managed Instance service problem classification. +```powershell +PS C:\> New-AzSupportTicket -Name "test1" -Title "Test" -Description "Test" -Severity "minimal" -ProblemClassificationId "/providers/Microsoft.Support/services/{quota_service_guid}/problemClassifications/{sql_managed_instance_problemClassification_guid}" -QuotaTicketDetail @{QuotaChangeRequestVersion = "1.0" ; QuotaChangeRequestSubType = "SQLMI" ; QuotaChangeRequests = (@{Region = "westus"; Payload = "{`"NewLimit`":200,`"Type`":`"vCore`" }"}, @{Region = "westus"; Payload = "{`"NewLimit`":200,`"Type`":`"Subnet`" }"})} -CustomerContactDetail @{FirstName = "first" ; LastName = "last" ; PreferredTimeZone = "pacific standard time" ; PreferredSupportLanguage = "en-us" ; Country = "USA" ; PreferredContactMethod = "Email" ; PrimaryEmailAddress = "user@contoso.com"} + +Name Title SupportTicketId Severity ServiceDisplayName Status CreatedDate +---- ----- --------------- -------- ------------------ ------ ----------- +test1 Test 150010521000317 Minimal Service and subscription limits (quotas) Open 2/5/2020 1:33:53 AM +``` + +### Example 16: Create a support ticket by specifying individual customer contact parameters instead of CustomerContactDetail object. ```powershell PS C:\> New-AzSupportTicket -Name "test1" -Title "Test" -Description "Test" -Severity "minimal" -ProblemClassificationId "/providers/Microsoft.Support/services/{billing_service_guid}/problemClassifications/{problemClassification_guid}" -CustomerFirstName "first" -CustomerLastName "last" -CustomerPreferredTimeZone "pacific standard time" -CustomerPreferredSupportLanguage "en-us" -CustomerCountry = "USA" -PreferredContactMethod "Email" -CustomerPrimaryEmailAddress "user@contoso.com" @@ -250,7 +259,7 @@ Name Title SupportTicketId Severity ServiceDisplayName Status CreatedDate test1 Test 150010521000317 Minimal Billing Open 2/5/2020 1:33:53 AM ``` -### Example 16: Create a support ticket with request for 24 x 7 response from Azure. +### Example 17: Create a support ticket with request for 24 x 7 response from Azure. ```powershell PS C:\> New-AzSupportTicket -Name "test1" -Title "Test" -Description "Test" -Severity "critical" -ProblemClassificationId "/providers/Microsoft.Support/services/{billing_service_guid}/problemClassifications/{problemClassification_guid}" -CustomerFirstName "first" -CustomerLastName "last" -CustomerPreferredTimeZone "pacific standard time" -CustomerPreferredSupportLanguage "en-us" -CustomerCountry = "USA" -PreferredContactMethod "Email" -CustomerPrimaryEmailAddress "user@contoso.com" -Require24X7Response @@ -259,7 +268,7 @@ Name Title SupportTicketId Severity ServiceDisplayName Status CreatedDate test1 Test 150010521000317 Critical Billing Open 2/5/2020 1:33:53 AM ``` -### Example 17: Create a support ticket on behalf of your customer if you are a Cloud Solution Provider (CSP). CSP should first login into their tenant, and then login into customer's tenant as shown in the example below. They must then use -CSPHomeTenantId parameter to specify their home tenant id at the time of creating a support ticket. +### Example 18: Create a support ticket on behalf of your customer if you are a Cloud Solution Provider (CSP). CSP should first login into their tenant, and then login into customer's tenant as shown in the example below. They must then use -CSPHomeTenantId parameter to specify their home tenant id at the time of creating a support ticket. ```powershell PS C:\> Login-AzAccount From 75ff50f96c080f8b8c90520743b3ba679f2a7a15 Mon Sep 17 00:00:00 2001 From: Bhavin Shah Date: Tue, 23 Jun 2020 18:29:24 -0700 Subject: [PATCH 3/3] reverting version changes --- src/Support/Support/Az.Support.psd1 | 2 +- src/Support/Support/ChangeLog.md | 3 --- 2 files changed, 1 insertion(+), 4 deletions(-) diff --git a/src/Support/Support/Az.Support.psd1 b/src/Support/Support/Az.Support.psd1 index fb1bcb523cd4..9d54f573fbf7 100644 --- a/src/Support/Support/Az.Support.psd1 +++ b/src/Support/Support/Az.Support.psd1 @@ -12,7 +12,7 @@ # RootModule = '' # Version number of this module. -ModuleVersion = '1.0.1' +ModuleVersion = '1.0.0' # Supported PSEditions CompatiblePSEditions = 'Core', 'Desktop' diff --git a/src/Support/Support/ChangeLog.md b/src/Support/Support/ChangeLog.md index f1557437b4fd..56f9adb57ef0 100644 --- a/src/Support/Support/ChangeLog.md +++ b/src/Support/Support/ChangeLog.md @@ -20,9 +20,6 @@ ## Upcoming Release -## Version 1.0.1 -* Documentation update of `Az.Support` module - ## Version 1.0.0 * General availability of `Az.Support` module