Added hostnames field for Application Gateway Listeners (#22871)

* Added hostnames field for Application Gateway Listeners

* added help files and change log.md

* Removed Unwanted network .csproj file chnages

* Removed unwanted extra spaces from Network.csproj

---------

Co-authored-by: Yabo Hu <[email protected]>

Author: gdhillon24

src/Network/Network/ApplicationGateway/Listener/AzureApplicationGatewayListenerBase.cs

@@ -81,6 +81,11 @@ public class AzureApplicationGatewayListenerBase : NetworkBaseCmdlet
         [ValidateNotNullOrEmpty]
         public string Protocol { get; set; }
 
+        [Parameter(
+            HelpMessage = "Host names")]
+        [ValidateNotNullOrEmpty]
+        public string[] HostNames { get; set; }
+
         public override void ExecuteCmdlet()
         {
             base.ExecuteCmdlet();
@@ -137,7 +142,12 @@ public PSApplicationGatewayListener NewObject()
             {
                 listener.SslProfile = new PSResourceId();
                 listener.SslProfile.Id = this.SslProfileId;
-            }            
+            }
+
+            if (this.HostNames != null)
+            {
+                listener.HostNames = this.HostNames?.ToList();
+            }
 
             listener.Id = ApplicationGatewayChildResourceHelper.GetResourceNotSetId(
                                 this.NetworkClient.NetworkManagementClient.SubscriptionId,

src/Network/Network/ChangeLog.md

@@ -24,6 +24,10 @@
 * Updated cmdlet `New-AzLoadBalancerBackendAddressPool` to support managed IP based backend
 * Added cmdlet `New-AzSaaSNetworkVirtualAppliance` for creating a NetworkVirtualAppliance of SaaS type.
 * Added control knobs to virtual network gateways and ExpressRoute gateways as well to cmdlets operating on those.
+* Updated cmdlets to add Hostnames property for Application gateway Listener Configuration
+	- `Set-AzApplicationGatewayListener`
+	- `Add-AzApplicationGatewayListener`
+	- `New-AzApplicationGatewayListener`
 * Added cmdlet 'Remove-AzApplicationGatewayFirewallCustomRule' to support removing custom rule in Firewall Policy.
 
 ## Version 6.2.0

src/Network/Network/Models/PSApplicationGatewayListener.cs

@@ -31,6 +31,8 @@ public class PSApplicationGatewayListener : PSChildResource
         public string Type { get; set; }
         public PSResourceId SslProfile { get; set; }
 
+        public List<string> HostNames { get; set; }
+
         [JsonIgnore]
         public string FrontendIpConfigurationText
         {

src/Network/Network/Network.csproj

@@ -47,4 +47,4 @@
 
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory).., build.proj))\src\Az.Post.props" />
 
-</Project>
+</Project>

src/Network/Network/help/Add-AzApplicationGatewayListener.md

@@ -17,15 +17,15 @@ Adds an listener to an application gateway.
 Add-AzApplicationGatewayListener -ApplicationGateway <PSApplicationGateway> -Name <String>
  [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
  [-FrontendPort <PSApplicationGatewayFrontendPort>] [-SslCertificate <PSApplicationGatewaySslCertificate>]
- [-SslProfile <PSApplicationGatewaySslProfile>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>]
+ [-SslProfile <PSApplicationGatewaySslProfile>] [-HostNames <String[]>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>]
  [<CommonParameters>]
 ```
 
 ### SetByResourceId
 ```
 Add-AzApplicationGatewayListener -ApplicationGateway <PSApplicationGateway> -Name <String>
  [-FrontendIPConfigurationId <String>] [-FrontendPortId <String>] [-SslCertificateId <String>]
- [-SslProfileId <String>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
+ [-SslProfileId <String>] [-HostNames <String[]>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>] [-HostNames <String[]>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -133,6 +133,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -HostNames
+Host names
+
+```yaml
+Type: System.String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Name
 The name of the Listener
 

src/Network/Network/help/New-AzApplicationGatewayListener.md

@@ -17,14 +17,14 @@ Creates an TCP\TLS listener for an application gateway.
 New-AzApplicationGatewayListener -Name <String>
  [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
  [-FrontendPort <PSApplicationGatewayFrontendPort>] [-SslCertificate <PSApplicationGatewaySslCertificate>]
- [-SslProfile <PSApplicationGatewaySslProfile>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>]
+ [-SslProfile <PSApplicationGatewaySslProfile>] [-HostNames <String[]>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>]
  [<CommonParameters>]
 ```
 
 ### SetByResourceId
 ```
 New-AzApplicationGatewayListener -Name <String> [-FrontendIPConfigurationId <String>]
- [-FrontendPortId <String>] [-SslCertificateId <String>] [-SslProfileId <String>] -Protocol <String>
+ [-FrontendPortId <String>] [-SslCertificateId <String>] [-SslProfileId <String>] [-HostNames <String[]>] -Protocol <String>
  [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
 ```
 
@@ -125,6 +125,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -HostNames
+Host names
+
+```yaml
+Type: System.String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Name
 The name of the Listener
 

src/Network/Network/help/Set-AzApplicationGatewayListener.md

@@ -17,15 +17,15 @@ Modifies a TCP\TLS listener for an application gateway.
 Set-AzApplicationGatewayListener -ApplicationGateway <PSApplicationGateway> -Name <String>
  [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
  [-FrontendPort <PSApplicationGatewayFrontendPort>] [-SslCertificate <PSApplicationGatewaySslCertificate>]
- [-SslProfile <PSApplicationGatewaySslProfile>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>]
+ [-SslProfile <PSApplicationGatewaySslProfile>] [-HostNames <String[]>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>]
  [<CommonParameters>]
 ```
 
 ### SetByResourceId
 ```
 Set-AzApplicationGatewayListener -ApplicationGateway <PSApplicationGateway> -Name <String>
  [-FrontendIPConfigurationId <String>] [-FrontendPortId <String>] [-SslCertificateId <String>]
- [-SslProfileId <String>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
+ [-SslProfileId <String>] [-HostNames <String[]>] -Protocol <String> [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -143,6 +143,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -HostNames
+Host names
+
+```yaml
+Type: System.String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Name
 The name of the Listener