Set-AzVirtualNetworkGatewayDefaultSite

Módulo:
Az.Network Module

Define o site padrão para um gateway de rede virtual.

Sintaxe

Default (Predefinição) 

Set-AzVirtualNetworkGatewayDefaultSite
    -VirtualNetworkGateway <PSVirtualNetworkGateway>
    -GatewayDefaultSite <PSLocalNetworkGateway>
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Descrição

O cmdlet Set-AzVirtualNetworkGatewayDefaultSite atribui um site padrão de encapsulamento forçado a um gateway de rede virtual. O tunelamento forçado oferece uma forma de redirecionar o tráfego ligado à Internet das máquinas virtuais do Azure para a sua rede local; isto permite-lhe inspecionar e auditar o tráfego antes de o libertar. O tunelamento forçado é realizado utilizando um túnel de rede privada virtual (VPN); este túnel requer um site predefinido, um gateway local onde todo o tráfego ligado à Internet do Azure é redirecionado. Set-AzVirtualNetworkGatewayDefaultSite fornece uma maneira de alterar o site padrão atribuído a um gateway.

Exemplos

Exemplo 1: Atribuir um site padrão a um gateway de rede virtual

$LocalGateway = Get-AzLocalNetworkGateway -Name "ContosoLocalGateway " -ResourceGroupName "ContosoResourceGroup"
$VirtualGateway = Get-AzVirtualNetworkGateway -Name "ContosoVirtualGateway"
Set-AzVirtualNetworkGatewayDefaultSite -GatewayDefaultSite $LocalGateway -VirtualNetworkGateway $VirtualGateway

Este exemplo atribui um site padrão a um gateway de rede virtual chamado ContosoVirtualGateway. O primeiro comando cria uma referência de objeto para um gateway local chamado ContosoLocalGateway. Essa referência de objeto armazenada na variável chamada $LocalGateway representa o gateway a ser configurado como o site padrão. O segundo comando, em seguida, cria uma referência de objeto para o gateway de rede virtual e armazena o resultado na variável chamada $VirtualGateway. O terceiro comando usa o cmdlet Set-AzVirtualNetworkGatewayDefaultSite para atribuir o site padrão a ContosoVirtualGateway.

Parâmetros

-AcquirePolicyToken

Adquira automaticamente um token Azure Policy para esta operação de recurso.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ChangeReference

A alteração do ID de referência do recurso para esta operação de recurso.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-GatewayDefaultSite

Especifica uma referência de objeto ao gateway de rede local a ser atribuído como o site padrão para a rede virtual especificada. Você pode usar o cmdlet Get-AzLocalNetworkGateway para criar uma referência de objeto para um gateway local.

Propriedades dos parâmetros

Tipo:PSLocalNetworkGateway
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-VirtualNetworkGateway

Especifica uma referência de objeto para o gateway de rede virtual onde o site padrão será atribuído. Você pode criar uma referência de objeto para um gateway de rede virtual usando Get-AzVirtualNetworkGateway e especificando o nome do gateway. A variável $VirtualGateway pode então ser usada como o valor do parâmetro para o parâmetro VirtualNetworkGateway :

Propriedades dos parâmetros

Tipo:PSVirtualNetworkGateway
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSVirtualNetworkGateway

PSLocalNetworkGateway

Saídas

PSVirtualNetworkGateway