Add an optional parameter called 'Location' to create/update action g…

…roup cmdls (#18678) * Task 14768687: AzNS || Powershell and SDK - Action Groups RP API's support for location * Add help and change log Co-authored-by: Thomas Pham <[email protected]>
Azure · Jun 28, 2022 · a2e29bb · a2e29bb
1 parent 4a44c97
commit a2e29bb
Show file tree

Hide file tree

Showing 3 changed files with 23 additions and 4 deletions.
diff --git a/src/Monitor/Monitor/ActionGroups/SetAzureRmActionGroupCommand.cs b/src/Monitor/Monitor/ActionGroups/SetAzureRmActionGroupCommand.cs
@@ -81,14 +81,23 @@ public class SetAzureRmActionGroupCommand : ManagementCmdletBase
         public SwitchParameter DisableGroup { get; set; }
 
         /// <summary>
-        /// Gets or sets the Tags of the activity log alert resource
+        /// Gets or sets the Tags of the action group resource
         /// </summary>
         [Parameter(ParameterSetName = ByPropertyName, Mandatory = false, ValueFromPipelineByPropertyName = true, HelpMessage = "The tags of the action group resource")]
         [Parameter(ParameterSetName = ByResourceId, Mandatory = false, ValueFromPipelineByPropertyName = true, HelpMessage = "The tags of the action group resource")]
         [Parameter(ParameterSetName = ByInputObject, Mandatory = false, ValueFromPipeline = true, HelpMessage = "The tags of the action group resource")]
         [ValidateNotNullOrEmpty]
         public IDictionary<string, string> Tag { get; set; }
 
+        /// <summary>
+        /// Gets or sets the location of the action group resource
+        /// </summary>
+        [Parameter(ParameterSetName = ByPropertyName, Mandatory = false, ValueFromPipelineByPropertyName = true, HelpMessage = "The location of the action group resource")]
+        [Parameter(ParameterSetName = ByResourceId, Mandatory = false, ValueFromPipelineByPropertyName = true, HelpMessage = "The location of the action group resource")]
+        [Parameter(ParameterSetName = ByInputObject, Mandatory = false, ValueFromPipeline = true, HelpMessage = "The location of the action group resource")]
+        [ValidateNotNullOrEmpty]
+        public string Location { get; set; }
+
         /// <summary>
         /// Gets or sets the resource id parameter.
         /// </summary>
@@ -130,6 +139,10 @@ protected override void ProcessRecordInternal()
                     {
                         this.Tag = this.InputObject.Tags;
                     }
+                    if (this.Location == null)
+                    {
+                        this.Location = this.InputObject.Location;
+                    }
                     this.Receiver = new List<PSActionGroupReceiverBase>();
                     this.Receiver.AddRange(this.InputObject.EmailReceivers);
                     this.Receiver.AddRange(this.InputObject.SmsReceivers);
@@ -224,7 +237,7 @@ protected override void ProcessRecordInternal()
 
                 ActionGroupResource actionGroup = new ActionGroupResource
                                                   {
-                                                      Location = "Global",
+                                                      Location = this.Location ?? "Global",
                                                       GroupShortName = this.ShortName,
                                                       Enabled = !this.DisableGroup.IsPresent || !this.DisableGroup,
                                                       Tags = this.Tag,

diff --git a/src/Monitor/Monitor/ChangeLog.md b/src/Monitor/Monitor/ChangeLog.md
@@ -19,6 +19,8 @@
 -->
 
 ## Upcoming Release
+## Version 3.0.2
+* Added optional parameter `Location` for Adding/Update action group cmdlet
 
 ## Version 3.0.1
 * Fixed an issue where users could not correctly ignore warning messages after setting environment variables [#17013]

diff --git a/src/Monitor/Monitor/help/Set-AzActionGroup.md b/src/Monitor/Monitor/help/Set-AzActionGroup.md
@@ -17,7 +17,7 @@ Creates a new or updates an existing action group.
 ```
 Set-AzActionGroup -ResourceGroupName <String> -Name <String> -ShortName <String>
  -Receiver <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Insights.OutputClasses.PSActionGroupReceiverBase]>
- [-DisableGroup] [-Tag <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
+ [-DisableGroup] [-Tag <System.Collections.Generic.IDictionary`2[System.String,System.String]>] [-Location <String>]
  [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -26,12 +26,13 @@ Set-AzActionGroup -ResourceGroupName <String> -Name <String> -ShortName <String>
 Set-AzActionGroup -ShortName <String>
  -Receiver <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Insights.OutputClasses.PSActionGroupReceiverBase]>
  [-DisableGroup] [-Tag <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
+ [-Location <String>]
  -ResourceId <String> [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### ByInputObject
 ```
-Set-AzActionGroup [-ShortName <String>] [-DisableGroup]
+Set-AzActionGroup [-ShortName <String>] [-DisableGroup] [-Location <String>]
  [-Tag <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
  -InputObject <PSActionGroupResource> [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm]
  [<CommonParameters>]
@@ -201,6 +202,9 @@ Accept wildcard characters: False
 ### -Tag
 The tags of the action group resource
 
+### -Location
+The location of the action group resource
+
 ```yaml
 Type: System.Collections.Generic.IDictionary`2[System.String,System.String]
 Parameter Sets: ByPropertyName, ByResourceId