Condividi tramite

Set-AzureRmVirtualNetworkGatewayDefaultSite

  • Riferimento
Modulo:
AzureRM.Network

Imposta il sito predefinito per un gateway di rete virtuale.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureRmVirtualNetworkGatewayDefaultSite
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   -GatewayDefaultSite <PSLocalNetworkGateway>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureRmVirtualNetworkGatewayDefaultSite assegna un sito predefinito di tunneling forzato a un gateway di rete virtuale. Il tunneling forzato consente di reindirizzare il traffico associato a Internet dalle macchine virtuali di Azure alla rete locale; in questo modo è possibile controllare e controllare il traffico prima di rilasciarlo. Il tunneling forzato viene eseguito tramite un tunnel di rete privata virtuale (VPN); questo tunnel richiede un sito predefinito, un gateway locale in cui viene reindirizzato tutto il traffico associato a Internet di Azure. Set-AzureRmVirtualNetworkGatewayDefaultSite consente di modificare il sito predefinito assegnato a un gateway.

Esempio

Esempio 1: Assegnare un sito predefinito a un gateway di rete virtuale

PS C:\>$LocalGateway = Get-AzureRmLocalNetworkGateway -Name "ContosoLocalGateway " -ResourceGroup "ContosoResourceGroup"
PS C:\> $VirtualGateway = Get-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway"
PS C:\> Set-AzureRmVirtualNetworkGatewayDefaultSite -GatewayDefaultSite $LocalGateway -VirtualNetworkGateway $VirtualGateway

Questo esempio assegna un sito predefinito a un gateway di rete virtuale denominato ContosoVirtualGateway. Il primo comando crea un riferimento a un oggetto a un gateway locale denominato ContosoLocalGateway. Questo riferimento all'oggetto archiviato nella variabile denominata $LocalGateway rappresenta il gateway da configurare come sito predefinito. Il secondo comando crea quindi un riferimento a un oggetto al gateway di rete virtuale e archivia il risultato nella variabile denominata $VirtualGateway. Il terzo comando usa il cmdlet Set-AzureRmVirtualNetworkGatewayDefaultSite per assegnare il sito predefinito a ContosoVirtualGateway.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GatewayDefaultSite

Specifica un riferimento all'oggetto al gateway di rete locale da assegnare come sito predefinito per la rete virtuale specificata. È possibile usare il cmdlet Get-AzureRmLocalNetworkGateway per creare un riferimento a un oggetto a un gateway locale.

Type:PSLocalNetworkGateway
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualNetworkGateway

Specifica un riferimento all'oggetto al gateway di rete virtuale in cui verrà assegnato il sito predefinito. È possibile creare un riferimento a un oggetto a un gateway di rete virtuale usando Get-AzureRmVirtualNetworkGateway e specificando il nome del gateway. La variabile $VirtualGateway può quindi essere usata come valore del parametro per il parametro VirtualNetworkGateway :

Type:PSVirtualNetworkGateway
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

PSVirtualNetworkGateway

Parametri: VirtualNetworkGateway (ByValue)

PSLocalNetworkGateway

Output

PSVirtualNetworkGateway