Partilhar via

Add-AzWebAppAccessRestrictionRule

Módulo:
Az.Websites Module

Adiciona uma regra de Restrição de Acesso a um Aplicativo Web do Azure.

Sintaxe

IpAddressParameterSet (Padrão) 

Add-AzWebAppAccessRestrictionRule
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    -Priority <UInt32>
    -IpAddress <String>
    [-Name <String>]
    [-Description <String>]
    [-Action <String>]
    [-SlotName <String>]
    [-TargetScmSite]
    [-PassThru]
    [-HttpHeader <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServiceTagParameterSet 

Add-AzWebAppAccessRestrictionRule
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    -Priority <UInt32>
    -ServiceTag <String>
    [-Name <String>]
    [-Description <String>]
    [-Action <String>]
    [-SlotName <String>]
    [-TargetScmSite]
    [-PassThru]
    [-HttpHeader <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SubnetNameParameterSet 

Add-AzWebAppAccessRestrictionRule
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    -Priority <UInt32>
    -SubnetName <String>
    -VirtualNetworkName <String>
    [-Name <String>]
    [-Description <String>]
    [-Action <String>]
    [-SlotName <String>]
    [-TargetScmSite]
    [-IgnoreMissingServiceEndpoint]
    [-PassThru]
    [-HttpHeader <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SubnetIdParameterSet 

Add-AzWebAppAccessRestrictionRule
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    -Priority <UInt32>
    -SubnetId <String>
    [-Name <String>]
    [-Description <String>]
    [-Action <String>]
    [-SlotName <String>]
    [-TargetScmSite]
    [-IgnoreMissingServiceEndpoint]
    [-PassThru]
    [-HttpHeader <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

O cmdlet Add-AzWebAppAccessRestrictionRule adiciona uma regra de Restrição de Acesso a um Aplicativo Web do Azure.

Exemplos

Exemplo 1: Adicionar regra de Restrição de Acesso a Endereço Ip a um Aplicativo Web

Add-AzWebAppAccessRestrictionRule -ResourceGroupName "Default-Web-WestUS" -WebAppName "ContosoSite" `
-Name IpRule -Priority 200 -Action Allow -IpAddress 10.10.0.0/8

Este comando adiciona uma regra de restrição de acesso com prioridade 200 e intervalo ip a um Aplicativo Web chamado ContosoSite que pertence ao grupo de recursos Default-Web-WestUS.

Exemplo 2: Adicionar regra de Restrição de Acesso ao Ponto Final do Serviço de Sub-rede a um Aplicativo Web

Add-AzWebAppAccessRestrictionRule -ResourceGroupName "Default-Web-WestUS" -WebAppName "ContosoSite" `
-Name SubnetRule -Priority 300 -Action Allow -SubnetName appgw-subnet -VirtualNetworkName corp-vnet

Este comando adiciona uma regra de restrição de acesso com prioridade 300 e com a sub-rede appgw-subnet em corp-vnet a um Aplicativo Web chamado ContosoSite que pertence ao grupo de recursos Default-Web-WestUS.

Exemplo 3: Adicionar regra de restrição de acesso ServiceTag a um aplicativo Web

Add-AzWebAppAccessRestrictionRule -ResourceGroupName "Default-Web-WestUS" -WebAppName "ContosoSite" `
-Name ServiceTagRule -Priority 200 -Action Allow -ServiceTag AzureFrontDoor.Backend

Este comando adiciona uma regra de restrição de acesso com prioridade 200 e uma Etiqueta de Serviço que representa o âmbito ip da Porta Frontal do Azure a uma Aplicação Web denominada ContosoSite que pertence ao grupo de recursos Default-Web-WestUS.

Exemplo 4: Adicionar regra de restrição de acesso de vários endereços a um aplicativo Web

Add-AzWebAppAccessRestrictionRule -ResourceGroupName "Default-Web-WestUS" -WebAppName "ContosoSite" `
-Name MultipleIpRule -Priority 200 -Action Allow -IpAddress "10.10.0.0/8,192.168.0.0/16"

Este comando adiciona uma regra de restrição de acesso com prioridade 200 e dois intervalos ip a um Aplicativo Web chamado ContosoSite que pertence ao grupo de recursos Default-Web-WestUS.

Exemplo 5: Adicionar regra de Restrição de Acesso com cabeçalho http a um Aplicativo Web

Add-AzWebAppAccessRestrictionRule -ResourceGroupName "Default-Web-WestUS" -WebAppName "ContosoSite" `
-Name MultipleIpRule -Priority 400 -Action Allow -ServiceTag AzureFrontDoor.Backend `
-HttpHeader @{'x-forwarded-host' = 'www.contoso.com', 'app.contoso.com'; 'x-azure-fdid' = '355deb06-47c4-4ba4-9641-c7d7a98b913e'}

Este comando adiciona uma regra de restrição de acesso com prioridade 400 para Service Tag AzureFrontDoor.Backend e restringe ainda mais o acesso apenas a cabeçalhos http de determinados valores a um Aplicativo Web chamado ContosoSite que pertence ao grupo de recursos Default-Web-WestUS.

Parâmetros

-Action

Regra Permitir ou Negar.

Propriedades dos parâmetros

Tipo:String
Valor padrão:Allow
Valores aceites:Allow, Deny
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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 padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Descrição da Restrição de Acesso.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-HttpHeader

Restrições de cabeçalho HTTP. Exemplo: -HttpHeader @{'x-azure-fdid' = '7acacb02-47ea-4cd4-b568-5e880e72582e'; 'x-forwarded-host' = 'www.contoso.com', 'app.contoso.com'}

Propriedades dos parâmetros

Tipo:Hashtable
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IgnoreMissingServiceEndpoint

Especifique se o registro do Service Endpoint na Sub-rede deve ser validado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

SubnetNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
SubnetIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IpAddress

Endereço IP v4 ou v6 CIDR intervalo. Por exemplo: 192.168.0.0/24

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

IpAddressParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Nome da regra

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

Retornar o objeto de configuração de restrição de acesso.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Priority

Prioridade de restrição de acesso. Ex.: 500.

Propriedades dos parâmetros

Tipo:UInt32
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

Nome do Grupo de Recursos

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ServiceTag

Nome da etiqueta de serviço

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ServiceTagParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-SlotName

Nome do slot de implantação.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-SubnetId

ResourceId da sub-rede.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

SubnetIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-SubnetName

Nome da sub-rede.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

SubnetNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-TargetScmSite

A regra destina-se ao site principal ou ao site do Scm.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualNetworkName

Nome da Rede Virtual.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

SubnetNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-WebAppName

o nome da aplicação Web.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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

String

Saídas

PSAccessRestrictionConfig