Set-AzVirtualNetworkGatewayConnection
Virtuális hálózati átjárókapcsolatot konfigurál.
Syntax
Default (Alapértelmezett)
Set-AzVirtualNetworkGatewayConnection
-VirtualNetworkGatewayConnection <PSVirtualNetworkGatewayConnection>
[-EnableBgp <Boolean>]
[-DpdTimeoutInSeconds <Int32>]
[-ConnectionMode <String>]
[-UsePolicyBasedTrafficSelectors <Boolean>]
[-UseLocalAzureIpAddress <Boolean>]
[-IpsecPolicies <PSIpsecPolicy[]>]
[-TrafficSelectorPolicy <PSTrafficSelectorPolicy[]>]
[-IngressNatRule <PSResourceId[]>]
[-EgressNatRule <PSResourceId[]>]
[-GatewayCustomBgpIpAddress <PSGatewayCustomBgpIpConfiguration[]>]
[-Force]
[-AsJob]
[-AuthenticationType <String>]
[-CertificateAuthentication <PSCertificateAuthentication>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzVirtualNetworkGatewayConnection
-VirtualNetworkGatewayConnection <PSVirtualNetworkGatewayConnection>
-Tag <Hashtable>
[-EnableBgp <Boolean>]
[-DpdTimeoutInSeconds <Int32>]
[-ConnectionMode <String>]
[-UsePolicyBasedTrafficSelectors <Boolean>]
[-UseLocalAzureIpAddress <Boolean>]
[-IpsecPolicies <PSIpsecPolicy[]>]
[-TrafficSelectorPolicy <PSTrafficSelectorPolicy[]>]
[-IngressNatRule <PSResourceId[]>]
[-EgressNatRule <PSResourceId[]>]
[-GatewayCustomBgpIpAddress <PSGatewayCustomBgpIpConfiguration[]>]
[-Force]
[-AsJob]
[-AuthenticationType <String>]
[-CertificateAuthentication <PSCertificateAuthentication>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Set-AzVirtualNetworkGatewayConnection parancsmag egy virtuális hálózati átjárókapcsolatot konfigurál.
Példák
1. példa:
$conn = Get-AzVirtualNetworkGatewayConnection -Name 1 -ResourceGroupName myRG
Set-AzVirtualNetworkGatewayConnection -VirtualNetworkGatewayConnection $conn
Confirm
Are you sure you want to overwrite resource '1'
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
Name : 1
ResourceGroupName : myRG
Location : westus
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Mi
crosoft.Network/connections/1
Etag : W/"00000000-0000-0000-0000-000000000000"
ResourceGuid : 00000000-0000-0000-0000-000000000000
ProvisioningState : Succeeded
Tags :
AuthorizationKey :
VirtualNetworkGateway1 : "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/M
icrosoft.Network/virtualNetworkGateways/myGateway"
VirtualNetworkGateway2 : "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/S2SVnetConn/providers/Mic
rosoft.Network/virtualNetworkGateways/S2SConnGW"
LocalNetworkGateway2 :
Peer :
RoutingWeight : 0
SharedKey :
ConnectionStatus : Connected
EgressBytesTransferred : 91334484
IngressBytesTransferred : 100386089
TunnelConnectionStatus : []
2. példa: Címkék hozzáadása/frissítése meglévő VirtualNetworkGatewayConnectionhoz
$conn = Get-AzVirtualNetworkGatewayConnection -Name 1 -ResourceGroupName myRG
Set-AzVirtualNetworkGatewayConnection -VirtualNetworkGatewayConnection $conn -Tag @{ testtagKey="SomeTagKey"; testtagValue="SomeKeyValue" }
Confirm
Are you sure you want to overwrite resource '1'
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
Name : 1
ResourceGroupName : myRG
Location : westus
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Mi
crosoft.Network/connections/1
Etag : W/"00000000-0000-0000-0000-000000000000"
ResourceGuid : 00000000-0000-0000-0000-000000000000
ProvisioningState : Succeeded
Tags :
Name Value
============ ============
testtagValue SomeKeyValue
testtagKey SomeTagKey
AuthorizationKey :
VirtualNetworkGateway1 : "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/M
icrosoft.Network/virtualNetworkGateways/myGateway"
VirtualNetworkGateway2 : "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/S2SVnetConn/providers/Mic
rosoft.Network/virtualNetworkGateways/S2SConnGW"
LocalNetworkGateway2 :
Peer :
RoutingWeight : 0
SharedKey :
ConnectionStatus : Connected
EgressBytesTransferred : 91334484
IngressBytesTransferred : 100386089
TunnelConnectionStatus : []
3. példa: NatRules hozzáadása/eltávolítása meglévő VirtualNetworkGatewayConnectionhoz
$conn = Get-AzVirtualNetworkGatewayConnection -Name 1 -ResourceGroupName myRG
$egressNatrule = Get-AzVirtualNetworkGatewayNatRule -ResourceGroupName myRG -Name "natRule1" -ParentResourceName "gw1"
Set-AzVirtualNetworkGatewayConnection -VirtualNetworkGatewayConnection $conn -IngressNatRule @() -EgressNatRule $egressNatrule
Confirm
Are you sure you want to overwrite resource '1'
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
Name : 1
ResourceGroupName : myRG
Location : westus
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Mi
crosoft.Network/connections/1
Etag : W/"00000000-0000-0000-0000-000000000000"
ResourceGuid : 00000000-0000-0000-0000-000000000000
ProvisioningState : Succeeded
Tags :
Name Value
============ ============
testtagValue SomeKeyValue
testtagKey SomeTagKey
AuthorizationKey :
VirtualNetworkGateway1 : "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/M
icrosoft.Network/virtualNetworkGateways/myGateway"
VirtualNetworkGateway2 : "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/S2SVnetConn/providers/Mic
rosoft.Network/virtualNetworkGateways/S2SConnGW"
LocalNetworkGateway2 :
Peer :
RoutingWeight : 0
SharedKey :
ConnectionStatus : Connected
EgressBytesTransferred : 91334484
IngressBytesTransferred : 100386089
TunnelConnectionStatus : []
IngressNatRules : []
EgressNatRules : [
{
"Id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Network/virtualNetworkGateways/gw1/natRules/natRule1"
}
]
Az első parancs lekéri az 1 nevű virtuális hálózati átjárókapcsolatot, amely a myRG erőforráscsoporthoz tartozik, és a $conn nevű változóban tárolja.
A második parancs lekéri a natRule1 nevű natRule virtuális hálózati átjárót, és a $egressNatrule nevű változóba tárolja.
A harmadik parancs beállítja a virtuális hálózati átjárókapcsolatot az összes IngressNatRules eltávolításával, és hozzáadja az egressNatrule-t az EgressNatRuleshez.
3. példa: GatewayCustomBgpIpAddress hozzáadása/eltávolítása meglévő VirtualNetworkGatewayConnectionhoz
$address1 = New-AzGatewayCustomBgpIpConfigurationObject -IpConfigurationId "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw/ipConfigurations/default" -CustomBgpIpAddress "169.254.21.1"
$address2 = New-AzGatewayCustomBgpIpConfigurationObject -IpConfigurationId "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw/ipConfigurations/ActiveActive" -CustomBgpIpAddress "169.254.21.3"
$conn = Get-AzVirtualNetworkGatewayConnection -ResourceGroupName PS_testing -ResourceName Conn
Set-AzVirtualNetworkGatewayConnection -VirtualNetworkGatewayConnection $conn -GatewayCustomBgpIpAddress $address1,$address2
Name : Conn
ResourceGroupName : PS_testing
Location : eastus
Id : /subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/connections/Conn
Etag : W/"e867e7bb-fa2e-436e-8822-70c556ec0f03"
ResourceGuid : 9c33f4f7-b09c-4080-932e-a44405a8c252
ProvisioningState : Succeeded
Tags :
AuthorizationKey :
VirtualNetworkGateway1 : "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw"
VirtualNetworkGateway2 :
LocalNetworkGateway2 : "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/localNetworkGateways/testLng"
Peer :
RoutingWeight : 3
SharedKey : abc
ExpressRouteGatewayBypass : False
EnablePrivateLinkFastPath : False
ConnectionStatus : Unknown
EgressBytesTransferred : 0
IngressBytesTransferred : 0
TunnelConnectionStatus : []
IngressNatRules : []
EgressNatRules : []
GatewayCustomBgpIpAddresses : [
{
"IpconfigurationId":
"/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw/ipConfigurations/default",
"CustomBgpIpAddress": "169.254.21.1"
},
{
"IpconfigurationId":
"/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw/ipConfigurations/ActiveActive",
"CustomBgpIpAddress": "169.254.21.3"
}
]
Ez új AzGatewayCustomBgpIpConfigurationObjects objektumot hoz létre, és frissíti az átjárókapcsolatot ezekkel a GatewayCustomBgpIpAddress szolgáltatással.
4. példa: GatewayCustomBgpIpAddress eltávolítása meglévő VirtualNetworkGatewayConnection-ra
$conn = Get-AzVirtualNetworkGatewayConnection -ResourceGroupName PS_testing -ResourceName Conn
Set-AzVirtualNetworkGatewayConnection -VirtualNetworkGatewayConnection $conn -GatewayCustomBgpIpAddress @()
Name : Conn
ResourceGroupName : PS_testing
Location : eastus
Id : /subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/connections/Conn
Etag : W/"863d9b89-a030-42ba-9f71-58d5bc3336a9"
ResourceGuid : 9c33f4f7-b09c-4080-932e-a44405a8c252
ProvisioningState : Succeeded
Tags :
AuthorizationKey :
VirtualNetworkGateway1 : "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw"
VirtualNetworkGateway2 :
LocalNetworkGateway2 : "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/localNetworkGateways/testLng"
Peer :
RoutingWeight : 3
SharedKey : abc
ExpressRouteGatewayBypass : False
EnablePrivateLinkFastPath : False
ConnectionStatus : NotConnected
EgressBytesTransferred : 0
IngressBytesTransferred : 0
TunnelConnectionStatus : []
IngressNatRules : []
EgressNatRules : []
GatewayCustomBgpIpAddresses : []
Ez frissíti az átjárókapcsolatot a GatewayCustomBgpIpAddress eltávolításával.
Paraméterek
-AsJob
Parancsmag futtatása a háttérben
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-AuthenticationType
A VPN-kapcsolat hitelesítési típusa: PSK vagy tanúsítvány
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Elfogadott értékek: PSK, Certificate
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-CertificateAuthentication
A VPN-kapcsolat tanúsítványhitelesítési konfigurációja
Paramétertulajdonságok
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Cf
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-ConnectionMode
Virtual Network átjáró kapcsolati üzemmódja.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-DefaultProfile
A Azure való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-DpdTimeoutInSeconds
A kapcsolat megszakadt társészlelési időtúllépése másodpercek alatt.
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-EgressNatRule
A kapcsolathoz társított kimenő NAT-szabályok listája.
Paramétertulajdonságok
Típus: PSResourceId [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-EnableBgp
BGP-munkamenet használata S2S VPN-alagúton keresztül
Paramétertulajdonságok
Típus: Nullable<T> [ Boolean ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-Force
Ne kérjen megerősítést, ha felülír egy erőforrást
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-GatewayCustomBgpIpAddress
A virtuális hálózati átjáró GatewayCustomBgpIpAddress elemét használja ebben a kapcsolatban.
Paramétertulajdonságok
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-IngressNatRule
A kapcsolathoz társított bejövő NAT-szabályok listája.
Paramétertulajdonságok
Típus: PSResourceId [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-IpsecPolicies
Az IPSec-szabályzatok listája.
Paramétertulajdonságok
Típus: PSIpsecPolicy [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-Tag
Erőforráscímkéket képviselő kivonatoló.
Paramétertulajdonságok
Típus: Hashtable
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
UpdateResourceWithTags
Position: Named
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-TrafficSelectorPolicy
A forgalomválasztó házirendek listája.
Paramétertulajdonságok
Típus: PSTrafficSelectorPolicy [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: True
Fennmaradó argumentumokból származó érték: False
-UseLocalAzureIpAddress
A PrivateIP használata S2S-kapcsolathoz
Paramétertulajdonságok
Típus: Nullable<T> [ Boolean ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-UsePolicyBasedTrafficSelectors
Szabályzatalapú forgalomválasztók használata S2S-kapcsolathoz
Paramétertulajdonságok
Típus: Nullable<T> [ Boolean ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-VirtualNetworkGatewayConnection
A VirtualNetworkGatewayConnection
Paramétertulajdonságok
Paraméterkészletek
(All)
Position: Named
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna.
A parancsmag nem fut.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Wi
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek