Get-AzExpressRouteGateway
Obtient une ressource ExpressRouteGateway à l’aide de ResourceGroupName et gatewayName OR répertorie toutes les passerelles par ResourceGroupName ou SubscriptionId.
Syntaxe
ListBySubscriptionId (Par défaut)
Get-AzExpressRouteGateway
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ListByResourceGroupName
Get-AzExpressRouteGateway
[-ResourceGroupName <String>]
[-Name <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByExpressRouteGatewayResourceId
Get-AzExpressRouteGateway
-ResourceId <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Obtient une ressource ExpressRouteGateway à l’aide de ResourceGroupName et gatewayName OR répertorie toutes les passerelles par ResourceGroupName ou SubscriptionId.
Exemples
Exemple 1
New-AzResourceGroup -Location "West Central US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West Central US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testExpressRoutegw" -VirtualHubId $virtualHub.Id -MinScaleUnits 2
Get-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testExpressRoutegw"
ResourceGroupName : testRG
Name : testExpressRoutegw
Id : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/ExpressRouteGateways/testExpressRoutegw
Location : West Central US
ExpressRouteGatewayScaleUnit : 2
VirtualHub : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings : {}
Type : Microsoft.Network/ExpressRouteGateways
ProvisioningState : Succeeded
La section ci-dessus crée un groupe de ressources, Virtual WAN, Virtual Network, Virtual Hub dans usa Centre-Ouest dans le groupe de ressources « testRG » dans Azure. Une passerelle ExpressRoute sera créée par la suite dans le hub virtuel avec 2 unités d’échelle.
Il obtient ensuite ExpressRouteGateway à l’aide de son nom resourceGroupName et du nom de la passerelle.
Exemple 2
Get-AzExpressRouteGateway -Name test*
ResourceGroupName : testRG
Name : testExpressRoutegw1
Id : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/ExpressRouteGateways/testExpressRoutegw1
Location : West Central US
ExpressRouteGatewayScaleUnit : 2
VirtualHub : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings : {}
Type : Microsoft.Network/ExpressRouteGateways
ProvisioningState : Succeeded
ResourceGroupName : testRG
Name : testExpressRoutegw2
Id : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/ExpressRouteGateways/testExpressRoutegw2
Location : West Central US
ExpressRouteGatewayScaleUnit : 2
VirtualHub : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings : {}
Type : Microsoft.Network/ExpressRouteGateways
ProvisioningState : Succeeded
Cette commande obtient tous les expressRouteGateways qui commencent par « test »
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Propriétés du paramètre
| Type: | IAzureContextContainer |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Nom de la ressource.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
| Alias: | ResourceName, ExpressRouteGatewayName |
Jeux de paramètres
ListByResourceGroupName
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResourceGroupName
Nom du groupe de ressources.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
ListByResourceGroupName
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResourceId
ID de ressource Azure pour que expressRouteGateway soit supprimé.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | expressRouteGatewayId |
Jeux de paramètres
ByExpressRouteGatewayResourceId
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
