Get-AzHost
Dient zum Abrufen oder Auflisten von Hosts.
Syntax
DefaultParameter (Standard)
Get-AzHost
[-ResourceGroupName] <String>
[-HostGroupName] <String>
[[-Name] <String>]
[-InstanceView]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ResourceIdParameter
Get-AzHost
[-ResourceId] <String>
[-InstanceView]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ruft einen Host in einer Hostgruppe ab. Dieses Cmdlet listet auch alle Hosts in einer Hostgruppe auf, wenn kein Hostname angegeben wird.
Beispiele
Beispiel 1
Get-AzHost -ResourceGroupName $resourceGroupName -HostGroupName $hostGroupName -Name $hostName
ResourceGroupName : myrg01
PlatformFaultDomain : 1
AutoReplaceOnFailure : True
HostId : 00000000-0000-0000-0000-000000000000
VirtualMachines[0] :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg01/providers/Microsoft.Compute/virtualMachines/myvm01
VirtualMachines[1] :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg01/providers/Microsoft.Compute/virtualMachines/myvm02
ProvisioningTime : 7/27/2019 3:22:59 AM
ProvisioningState : Succeeded
Sku :
Name : ESv3-Type1
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg01/providers/Microsoft.Compute/hostGroups/myhostgroup01/hosts/myhost01
Name : myhost01
Location : eastus
Tags : {"key1":"val2"}
Dieser Befehl gibt einen Host zurück.
Beispiel 2
Get-AzHost -ResourceGroupName $resourceGroupName -HostGroupName $hostGroupName -Name $hostName -InstanceView
ResourceGroupName : myrg01
PlatformFaultDomain : 0
AutoReplaceOnFailure : True
HostId : 00000000-0000-0000-0000-000000000000
ProvisioningTime : 8/19/2019 9:13:19 PM
ProvisioningState : Succeeded
InstanceView :
AssetId : 00000000-0000-0000-0000-000000000000
AvailableCapacity :
AllocatableVMs[0] :
VmSize : Standard_E2s_v3
Count : 28
AllocatableVMs[1] :
VmSize : Standard_E4-2s_v3
Count : 14
AllocatableVMs[2] :
VmSize : Standard_E4s_v3
Count : 14
Statuses[0] :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Provisioning succeeded
Time : 8/19/2019 9:13:19 PM
Statuses[1] :
Code : HealthState/available
Level : Info
DisplayStatus : Host available
Sku :
Name : ESv3-Type1
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg01/providers/Microsoft.Compute/hostGroups/myhostgroup01/hosts/myhost01
Name : crptestps2264host
Location : eastus
Tags : {"key1":"val2"}
Dieser Befehl gibt die Instanzansicht eines Hosts zurück.
Beispiel 3
Get-AzHost -ResourceGroupName $resourceGroupName -HostGroupName $hostGroupName
ResourceGroupName Name Location Tags Sku FD
----------------- ---- -------- ---- --- --
myrg01 myhost01 eastus {[key1, val2]} ESv3-Type1 0
myrg01 myhost02 eastus {[key1, val2]} ESv3-Type1 1
Dieser Befehl gibt alle Hosts in der angegebenen Hostgruppe zurück.
Beispiel 4: Dieser Befehl gibt einen Host für bereitgestellte -ResourceId zurück.
$rgname = "rgname"
$loc = "eastus"
$hostGroupName = $rgname + "HostGroup"
$hostName = $rgname + "Host"
$Sku = "ESv3-Type1"
# Create Hostgroup and Hostgroupname
New-AzHostGroup -ResourceGroupName $rgname -Name $hostGroupName -Location $loc -PlatformFaultDomain 1 -Zone "2"
New-AzHost -ResourceGroupName $rgname -HostGroupName $hostGroupName -Name $hostName -Location $loc -Sku $Sku
# Fetch Host using -ResourceId
$dedicatedHost = Get-AzHost -ResourceGroupName $rgname -HostGroupName $hostGroupName -Name $hostName
$host = Get-AzHost -ResourceId $dedicatedHost.Id
ResourceGroupName : rgname
PlatformFaultDomain : 0
AutoReplaceOnFailure : True
HostId : 0730655b-051d-4559-a83a-5d579d15fec2
ProvisioningTime : 10/14/2022 7:28:47 AM
ProvisioningState : Succeeded
Sku :
Name : ESv3-Type1
Id : /subscriptions/e37510d7-33b6-4676-886f-ee75bcc01871/resourceGroups/rgname/providers/Microsoft.Compute/hostGroups/rgnameHostGroup/hosts/rgnameHost
Name : rgnameHost
Type : Microsoft.Compute/hostGroups/hosts
Location : eastus
Tags : {}
Parameter
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
| Typ: | IAzureContextContainer |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | AzContext, AzureRmContext, AzureCredential |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-HostGroupName
Der Name der Hostgruppe.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
DefaultParameter
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-InstanceView
Gibt an, dass dieses Cmdlet nur die Instanzansicht des Hosts abruft.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Der Name des Hosts.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Hostname (Rechnername) |
Parametersätze
DefaultParameter
| Position: | 2 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ResourceGroupName
Der Name der Ressourcengruppe
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
DefaultParameter
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ResourceId
Die ID der Ressource.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ResourceIdParameter
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
