[Compute] HostGroup: add InstanceView parameter to Get-AzHostGroup (#12554)

* Added the InstanceView switch to the Get-AzHostGroup cmdlet

* Added test for instanceview switch and re-recorded resources

* Updated documentation

Author: madewithsmiles

src/Compute/Compute.Test/ScenarioTests/DedicatedHostTests.ps1

@@ -79,6 +79,12 @@ function Test-DedicatedHost
         Assert-AreEqual 1 $hostGroup.Hosts.Count;
         Assert-AreEqual 1 $hostGroup.Count;
 
+        $hostGroupInstanceViewResult = Get-AzHostGroup -ResourceGroupName $rgname -Name $hostGroupName -InstanceView;
+        Assert-NotNull $hostGroupInstanceViewResult.Hosts;
+        foreach ($hostInstanceViewWithName in $hostGroupInstanceViewResult.Hosts) {
+            Assert-NotNull $hostInstanceViewWithName.Name;
+        } 
+
         Remove-AzHost -ResourceGroupName $rgname -HostGroupName $hostGroupName -Name $hostName;
 
         Assert-ThrowsContains {

src/Compute/Compute.Test/SessionRecords/Microsoft.Azure.Commands.Compute.Test.ScenarioTests.DedicatedHostTests/TestDedicatedHost.json

@@ -19,6 +19,8 @@
         - Additional information about change #1
 -->
 ## Upcoming Release
+* Added the '-InstanceView' switch as optional parameter to Get-AzHostGroup
+
 
 ## Version 4.2.1
 * Added warning when using `New-AzVmss` without "latest" image version.

src/Compute/Compute.Test/SessionRecords/Microsoft.Azure.Commands.Compute.Test.ScenarioTests.DedicatedHostTests/TestDedicatedHostVirtualMachine.json

@@ -56,10 +56,21 @@ public override void ExecuteCmdlet()
 
                 if (!string.IsNullOrEmpty(resourceGroupName) && !string.IsNullOrEmpty(hostGroupName))
                 {
-                    var result = DedicatedHostGroupsClient.Get(resourceGroupName, hostGroupName);
-                    var psObject = new PSHostGroup();
-                    ComputeAutomationAutoMapperProfile.Mapper.Map<DedicatedHostGroup, PSHostGroup>(result, psObject);
-                    WriteObject(psObject);
+                    if (this.InstanceView.IsPresent)
+                    {
+                        var result = DedicatedHostGroupsClient.Get(resourceGroupName, hostGroupName, InstanceViewTypes.InstanceView).InstanceView;
+                        var psObject = new PSHostGroupInstanceView();
+                        ComputeAutoMapperProfile.Mapper.Map<DedicatedHostGroupInstanceView, PSHostGroupInstanceView>(result, psObject);
+                        WriteObject(psObject);
+                    }
+                    else 
+                    {
+                        var result = DedicatedHostGroupsClient.Get(resourceGroupName, hostGroupName);
+                        var psObject = new PSHostGroup();
+                        ComputeAutomationAutoMapperProfile.Mapper.Map<DedicatedHostGroup, PSHostGroup>(result, psObject);
+                        WriteObject(psObject);
+                    }
+
                 }
                 else if (!string.IsNullOrEmpty(resourceGroupName))
                 {
@@ -121,6 +132,12 @@ public override void ExecuteCmdlet()
         [ResourceNameCompleter("Microsoft.Compute/hostGroups", "ResourceGroupName")]
         public string Name { get; set; }
 
+        [Parameter(
+            ParameterSetName = "DefaultParameter",
+            Mandatory=false
+        )]
+        public SwitchParameter InstanceView { get; set; } = false;
+
         [Parameter(
             ParameterSetName = "ResourceIdParameter",
             Position = 0,

src/Compute/Compute/ChangeLog.md

@@ -0,0 +1,27 @@
+//
+// Copyright (c) Microsoft and contributors.  All rights reserved.
+//
+// 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.
+//
+
+using System.Collections.Generic;
+using Microsoft.Azure.Management.Compute.Models;
+
+
+namespace Microsoft.Azure.Commands.Compute.Automation.Models
+{
+    public partial class PSHostGroupInstanceView
+    {
+        public IList<DedicatedHostInstanceViewWithName> Hosts { get; set; }
+    }
+}

src/Compute/Compute/Generated/DedicatedHostGroup/DedicatedHostGroupGetMethod.cs

@@ -14,8 +14,8 @@ Get or list hosts.
 
 ### DefaultParameter (Default)
 ```
-Get-AzHostGroup [[-ResourceGroupName] <String>] [[-Name] <String>] [-DefaultProfile <IAzureContextContainer>]
- [<CommonParameters>]
+Get-AzHostGroup [[-ResourceGroupName] <String>] [[-Name] <String>] [-InstanceView]
+ [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
 ```
 
 ### ResourceIdParameter
@@ -88,6 +88,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -InstanceView
+Expand the returned object to also list the host's instance views. 
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: DefaultParameter
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Name
 The name of the host group.