Freigeben über


Add-AzWebAppAccessRestrictionRule

Fügt einer Azure Web App eine Zugriffseinschränkungsregel hinzu.

Syntax

IpAddressParameterSet (Standardwert)

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>]

Beschreibung

Das cmdlet Add-AzWebAppAccessRestrictionRule fügt einer Azure Web App eine Zugriffseinschränkungsregel hinzu.

Beispiele

Beispiel 1: Hinzufügen einer IpAddress-Zugriffseinschränkungsregel zu einer Web App

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

Dieser Befehl fügt eine Zugriffseinschränkungsregel mit Priorität 200 und IP-Bereich zu einer Web App mit dem Namen ContosoSite hinzu, die zur Ressourcengruppe Default-Web-WestUS gehört.

Beispiel 2: Hinzufügen einer Accesseinschränkungsregel für Subnetzdienste zu einer Web App

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

Mit diesem Befehl wird eine Zugriffseinschränkungsregel mit Priorität 300 und mit subnetz appgw-subnetz in corp-vnet zu einer Web App namens ContosoSite hinzugefügt, die zur Ressourcengruppe "Default-Web-WestUS" gehört.

Beispiel 3: Hinzufügen einer ServiceTag-Zugriffseinschränkungsregel zu einer Web App

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

Mit diesem Befehl wird eine Zugriffseinschränkungsregel mit Priorität 200 und ein Diensttag hinzugefügt, der den IP-Bereich von Azure Front Door zu einer Web App namens ContosoSite darstellt, die zur Ressourcengruppe "Default-Web-WestUS" gehört.

Beispiel 4: Hinzufügen einer Zugriffseinschränkungsregel mit mehreren Adressen zu einer Web App

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"

Mit diesem Befehl wird eine Zugriffseinschränkungsregel mit Priorität 200 und zwei IP-Bereichen zu einer Web App namens ContosoSite hinzugefügt, die zur Ressourcengruppe Default-Web-WestUS gehört.

Beispiel 5: Hinzufügen einer Zugriffseinschränkungsregel mit http-Header zu einer Web App

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'}

Mit diesem Befehl wird eine Zugriffseinschränkungsregel mit Priorität 400 für Servicetag AzureFrontDoor.Back hinzugefügt und der Zugriff nur auf HTTP-Header bestimmter Werte auf eine Web App namens ContosoSite beschränkt, die zur Ressourcengruppe "Default-Web-WestUS" gehört.

Parameter

-Action

Regel zulassen oder ablehnen.

Parametereigenschaften

Typ:String
Standardwert:Allow
Zulässige Werte:Allow, Deny
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Beschreibung der Zugriffseinschränkung.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HttpHeader

Http-Headereinschränkungen. Beispiel: -HttpHeader @{'x-azure-fdid' = '7acacb02-47ea-4cd4-b568-5e880e72582e'; 'x-forwarded-host' = 'www.contoso.com', 'app.contoso.com'}

Parametereigenschaften

Typ:Hashtable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IgnoreMissingServiceEndpoint

Geben Sie an, ob die Registrierung des Dienstendpunkts bei Subnetz überprüft werden soll.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SubnetNameParameterSet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
SubnetIdParameterSet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IpAddress

IP-Adresse v4 oder v6 CIDR-Bereich. Beispiel: 192.168.0.0/24

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

IpAddressParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Regelname

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt das Config-Objekt der Zugriffseinschränkung zurück.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Priority

Zugriffsbeschränkungspriorität. Z.B.: 500.

Parametereigenschaften

Typ:UInt32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Ressourcengruppenname

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServiceTag

Name des Diensttags

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ServiceTagParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SlotName

Name des Bereitstellungsplatzes.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubnetId

ResourceId von Subnetz.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SubnetIdParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubnetName

Name des Subnetzs.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SubnetNameParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TargetScmSite

Regel richtet sich an die Hauptwebsite oder die Scm-Website.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualNetworkName

Name des virtuellen Netzwerks.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SubnetNameParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WebAppName

Der Name der Web-App.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Ausgaben

PSAccessRestrictionConfig