Azure DNS Resolver Outbound resources for Private Preview (#15448)

* made some changes

* made some changes

* made some changes

* made some changes

* made some changes

* made some changes

* made some changes

* made some changes

* made some changes

* made some changes

* reverting inbound changes

* made some changes

* resolving comments

* made some changes

* PR comments addressed - reverting any inbound changes

* revered DnsResolver Get changes

* revered readme

* Reverted all Inbound scenarios

* revered update inbound

* Reverted

* Update GeneratedModuleList.txt

try to fix CI error

* updated readme and added spec file to PS repo

* Unskip DnsResolver for CI

* add common types spec

* ensured swagger diff is resolved

* fix casing in readme

* resolved help link issue

* suppress signature issues

Co-authored-by: Yeming Liu <[email protected]>
Co-authored-by: Yeming Liu <[email protected]>

Author: sangs-msft

src/DnsResolver/Az.DnsResolver.psd1

@@ -9,9 +9,9 @@
   Description = 'Microsoft Azure PowerShell: DnsResolver cmdlets'
   PowerShellVersion = '5.1'
   DotNetFrameworkVersion = '4.7.2'
-  RequiredAssemblies = './bin/DnsResolver.private.dll'
+  RequiredAssemblies = './bin/Az.DnsResolver.private.dll'
   FormatsToProcess = './Az.DnsResolver.format.ps1xml'
-  FunctionsToExport = 'Get-AzDnsResolver', 'Get-AzDnsResolverInboundEndpoint', 'New-AzDnsResolver', 'New-AzDnsResolverInboundEndpoint', 'New-AzDnsResolverIPConfigurationObject', 'Remove-AzDnsResolver', 'Remove-AzDnsResolverInboundEndpoint', 'Update-AzDnsResolver', 'Update-AzDnsResolverInboundEndpoint', '*'
+  FunctionsToExport = 'Get-AzDnsResolver', 'Get-AzDnsResolverDnsForwardingRuleset', 'Get-AzDnsResolverForwardingRule', 'Get-AzDnsResolverInboundEndpoint', 'Get-AzDnsResolverOutboundEndpoint', 'Get-AzDnsResolverVirtualNetworkLink', 'New-AzDnsResolver', 'New-AzDnsResolverDnsForwardingRuleset', 'New-AzDnsResolverForwardingRule', 'New-AzDnsResolverInboundEndpoint', 'New-AzDnsResolverIPConfigurationObject', 'New-AzDnsResolverOutboundEndpoint', 'New-AzDnsResolverTargetDnsServerObject', 'New-AzDnsResolverVirtualNetworkLink', 'Remove-AzDnsResolver', 'Remove-AzDnsResolverDnsForwardingRuleset', 'Remove-AzDnsResolverForwardingRule', 'Remove-AzDnsResolverInboundEndpoint', 'Remove-AzDnsResolverOutboundEndpoint', 'Remove-AzDnsResolverVirtualNetworkLink', 'Update-AzDnsResolver', 'Update-AzDnsResolverDnsForwardingRuleset', 'Update-AzDnsResolverForwardingRule', 'Update-AzDnsResolverInboundEndpoint', 'Update-AzDnsResolverOutboundEndpoint', 'Update-AzDnsResolverVirtualNetworkLink', '*'
   AliasesToExport = '*'
   PrivateData = @{
     PSData = @{

src/DnsResolver/custom/New-AzDnsResolverIPConfigurationObject.ps1

@@ -22,7 +22,7 @@ Create a in-memory object for IPConfiguration
 .Outputs
 Microsoft.Azure.PowerShell.Cmdlets.DnsResolver.Models.Api20200401Preview.IPConfiguration
 .Link
-https://docs.microsoft.com/en-us/powershell/module/az.DnsResolver/new-AzDnsResolverIPConfigurationObject
+https://docs.microsoft.com/powershell/module/az.dnsresolver/new-azdnsresolveripconfigurationobject
 #>
 function New-AzDnsResolverIPConfigurationObject {
     [OutputType('Microsoft.Azure.PowerShell.Cmdlets.DnsResolver.Models.Api20200401Preview.IPConfiguration')]

src/DnsResolver/custom/New-AzDnsResolverTargetDnsServer.ps1

@@ -0,0 +1,48 @@
+
+# ----------------------------------------------------------------------------------
+#
+# Copyright Microsoft Corporation
+# Licensed under the Apache License, Version 2.0 (the \"License\");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an \"AS IS\" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ----------------------------------------------------------------------------------
+
+<#
+.Synopsis
+Create a in-memory object for Target DNS server
+.Description
+Create a in-memory object for Target DNS server
+
+.Outputs
+Microsoft.Azure.PowerShell.Cmdlets.DnsResolver.Models.Api20200401Preview.TargetDnsServer
+.Link
+https://docs.microsoft.com/powershell/module/az.dnsresolver/new-azdnsresolvertargetdnsserverobject
+#>
+function New-AzDnsResolverTargetDnsServerObject {
+    [OutputType('Microsoft.Azure.PowerShell.Cmdlets.DnsResolver.Models.Api20200401Preview.TargetDnsServer')]
+    [CmdletBinding(PositionalBinding=$false)]
+    Param(
+
+        [Parameter(HelpMessage="DNS server IP address.")]
+        [string]
+        $IPAddress,
+        [Parameter(HelpMessage="DNS server port.")]
+        [int]
+        $Port
+    )
+
+    process {
+        $Object = [Microsoft.Azure.PowerShell.Cmdlets.DnsResolver.Models.Api20200401Preview.TargetDnsServer]::New()
+
+        $Object.IPAddress = $IPAddress
+        $Object.Port = $Port
+        return $Object
+    }
+}
+

src/DnsResolver/custom/readme.md

@@ -10,7 +10,7 @@ This directory contains custom implementation for non-generated cmdlets for the
 ## Details
 For `Az.DnsResolver` to use custom cmdlets, it does this two different ways. We **highly recommend** creating script cmdlets, as they are easier to write and allow access to the other exported cmdlets. C# cmdlets *cannot access exported cmdlets*.
 
-For C# cmdlets, they are compiled with the rest of the generated low-level cmdlets into the `./bin/DnsResolver.private.dll`. The names of the cmdlets (methods) and files must follow the `[cmdletName]_[variantName]` syntax used for generated cmdlets. The `variantName` is used as the `ParameterSetName`, so use something appropriate that doesn't clash with already created variant or parameter set names. You cannot use the `ParameterSetName` property in the `Parameter` attribute on C# cmdlets. Each cmdlet must be separated into variants using the same pattern as seen in the `generated/cmdlets` folder.
+For C# cmdlets, they are compiled with the rest of the generated low-level cmdlets into the `./bin/Az.DnsResolver.private.dll`. The names of the cmdlets (methods) and files must follow the `[cmdletName]_[variantName]` syntax used for generated cmdlets. The `variantName` is used as the `ParameterSetName`, so use something appropriate that doesn't clash with already created variant or parameter set names. You cannot use the `ParameterSetName` property in the `Parameter` attribute on C# cmdlets. Each cmdlet must be separated into variants using the same pattern as seen in the `generated/cmdlets` folder.
 
 For script cmdlets, these are loaded via the `Az.DnsResolver.custom.psm1`. Then, during the build process, this module is loaded and processed in the same manner as the C# cmdlets. The fundemental difference is the script cmdlets use the `ParameterSetName` attribute and C# cmdlets do not. To create a script cmdlet variant of a generated cmdlet, simply decorate all parameters in the script with the new `ParameterSetName` in the `Parameter` attribute. This will appropriately treat each parameter set as a separate variant when processed to be exported during the build.
 

src/DnsResolver/docs/Az.DnsResolver.md

@@ -14,29 +14,85 @@ Microsoft Azure PowerShell: DnsResolver cmdlets
 ### [Get-AzDnsResolver](Get-AzDnsResolver.md)
 Gets properties of a DNS resolver.
 
+### [Get-AzDnsResolverDnsForwardingRuleset](Get-AzDnsResolverDnsForwardingRuleset.md)
+Gets a DNS forwarding ruleset properties.
+
+### [Get-AzDnsResolverForwardingRule](Get-AzDnsResolverForwardingRule.md)
+Gets properties of a forwarding rule in a DNS forwarding ruleset.
+
 ### [Get-AzDnsResolverInboundEndpoint](Get-AzDnsResolverInboundEndpoint.md)
 Gets properties of an inbound endpoint for a DNS resolver.
 
+### [Get-AzDnsResolverOutboundEndpoint](Get-AzDnsResolverOutboundEndpoint.md)
+Gets properties of an outbound endpoint for a DNS resolver.
+
+### [Get-AzDnsResolverVirtualNetworkLink](Get-AzDnsResolverVirtualNetworkLink.md)
+Gets properties of a virtual network link to a DNS forwarding ruleset.
+
 ### [New-AzDnsResolver](New-AzDnsResolver.md)
 Creates or updates a DNS resolver.
 
+### [New-AzDnsResolverDnsForwardingRuleset](New-AzDnsResolverDnsForwardingRuleset.md)
+Creates or updates a DNS forwarding ruleset.
+
+### [New-AzDnsResolverForwardingRule](New-AzDnsResolverForwardingRule.md)
+Creates or updates a forwarding rule in a DNS forwarding ruleset.
+
 ### [New-AzDnsResolverInboundEndpoint](New-AzDnsResolverInboundEndpoint.md)
 Creates or updates an inbound endpoint for a DNS resolver.
 
 ### [New-AzDnsResolverIPConfigurationObject](New-AzDnsResolverIPConfigurationObject.md)
 Create a in-memory object for IPConfiguration
 
+### [New-AzDnsResolverOutboundEndpoint](New-AzDnsResolverOutboundEndpoint.md)
+Creates or updates an outbound endpoint for a DNS resolver.
+
+### [New-AzDnsResolverTargetDnsServerObject](New-AzDnsResolverTargetDnsServerObject.md)
+Create a in-memory object for Target DNS server
+
+### [New-AzDnsResolverVirtualNetworkLink](New-AzDnsResolverVirtualNetworkLink.md)
+Creates or updates a virtual network link to a DNS forwarding ruleset.
+
 ### [Remove-AzDnsResolver](Remove-AzDnsResolver.md)
 Deletes a DNS resolver.
 WARNING: This operation cannot be undone.
 
+### [Remove-AzDnsResolverDnsForwardingRuleset](Remove-AzDnsResolverDnsForwardingRuleset.md)
+Deletes a DNS forwarding ruleset.
+WARNING: This operation cannot be undone.
+All forwarding rules within the ruleset will be deleted.
+
+### [Remove-AzDnsResolverForwardingRule](Remove-AzDnsResolverForwardingRule.md)
+Deletes a forwarding rule in a DNS forwarding ruleset.
+WARNING: This operation cannot be undone.
+
 ### [Remove-AzDnsResolverInboundEndpoint](Remove-AzDnsResolverInboundEndpoint.md)
 Deletes an inbound endpoint for a DNS resolver.
 WARNING: This operation cannot be undone.
 
+### [Remove-AzDnsResolverOutboundEndpoint](Remove-AzDnsResolverOutboundEndpoint.md)
+Deletes an outbound endpoint for a DNS resolver.
+WARNING: This operation cannot be undone.
+
+### [Remove-AzDnsResolverVirtualNetworkLink](Remove-AzDnsResolverVirtualNetworkLink.md)
+Deletes a virtual network link to a DNS forwarding ruleset.
+WARNING: This operation cannot be undone.
+
 ### [Update-AzDnsResolver](Update-AzDnsResolver.md)
 Updates a DNS resolver.
 
+### [Update-AzDnsResolverDnsForwardingRuleset](Update-AzDnsResolverDnsForwardingRuleset.md)
+Updates a DNS forwarding ruleset.
+
+### [Update-AzDnsResolverForwardingRule](Update-AzDnsResolverForwardingRule.md)
+Updates a forwarding rule in a DNS forwarding ruleset.
+
 ### [Update-AzDnsResolverInboundEndpoint](Update-AzDnsResolverInboundEndpoint.md)
 Updates an inbound endpoint for a DNS resolver.
 
+### [Update-AzDnsResolverOutboundEndpoint](Update-AzDnsResolverOutboundEndpoint.md)
+Updates an outbound endpoint for a DNS resolver.
+
+### [Update-AzDnsResolverVirtualNetworkLink](Update-AzDnsResolverVirtualNetworkLink.md)
+Updates a virtual network link to a DNS forwarding ruleset.
+

src/DnsResolver/docs/Get-AzDnsResolver.md

@@ -35,12 +35,6 @@ Get-AzDnsResolver -ResourceGroupName <String> [-SubscriptionId <String[]>] [-Top
  [-DefaultProfile <PSObject>] [<CommonParameters>]
 ```
 
-### List2
-```
-Get-AzDnsResolver -ResourceGroupName <String> -VirtualNetworkName <String> [-SubscriptionId <String[]>]
- [-Top <Int32>] [-DefaultProfile <PSObject>] [<CommonParameters>]
-```
-
 ## DESCRIPTION
 Gets properties of a DNS resolver.
 
@@ -146,7 +140,7 @@ The name is case insensitive.
 
 ```yaml
 Type: System.String
-Parameter Sets: Get, List, List2
+Parameter Sets: Get, List
 Aliases:
 
 Required: True
@@ -161,7 +155,7 @@ The ID of the target subscription.
 
 ```yaml
 Type: System.String[]
-Parameter Sets: Get, List, List1, List2
+Parameter Sets: Get, List, List1
 Aliases:
 
 Required: False
@@ -177,7 +171,7 @@ If not specified, returns up to 100 results.
 
 ```yaml
 Type: System.Int32
-Parameter Sets: List, List1, List2
+Parameter Sets: List, List1
 Aliases:
 
 Required: False
@@ -187,21 +181,6 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -VirtualNetworkName
-The name of the virtual network.
-
-```yaml
-Type: System.String
-Parameter Sets: List2
-Aliases:
-
-Required: True
-Position: Named
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
@@ -223,12 +202,15 @@ To create the parameters described below, construct a hash table containing the
 
 
 INPUTOBJECT <IDnsResolverIdentity>: Identity Parameter
+  - `[DnsForwardingRulesetName <String>]`: The name of the DNS forwarding ruleset.
   - `[DnsResolverName <String>]`: The name of the DNS resolver.
+  - `[ForwardingRuleName <String>]`: The name of the forwarding rule.
   - `[Id <String>]`: Resource identity path
   - `[InboundEndpointName <String>]`: The name of the inbound endpoint for the DNS resolver.
+  - `[OutboundEndpointName <String>]`: The name of the outbound endpoint for the DNS resolver.
   - `[ResourceGroupName <String>]`: The name of the resource group. The name is case insensitive.
   - `[SubscriptionId <String>]`: The ID of the target subscription.
-  - `[VirtualNetworkName <String>]`: The name of the virtual network.
+  - `[VirtualNetworkLinkName <String>]`: The name of the virtual network link.
 
 ## RELATED LINKS