Freigeben über

Set-AzNetworkInterfaceIpConfig

Modul:
Az.Network Module

Aktualisiert eine IP-Konfiguration für eine Netzwerkschnittstelle.

Syntax

SetByResource (Standard) 

Set-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

Set-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzNetworkInterfaceIpConfig aktualisiert eine IP-Konfiguration für eine Netzwerkschnittstelle.

Beispiele

Beispiel 1: Ändern der IP-Adresse einer IP-Konfiguration

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary

$nic | Set-AzNetworkInterface

Die ersten beiden Befehle erhalten ein virtuelles Netzwerk namens "myvnet" und ein Subnetz namens "mysubnet" und speichern es in den Variablen $vnet bzw. $subnet. Der dritte Befehl ruft die Netzwerkschnittstelle nic1 ab, die der IP-Konfiguration zugeordnet ist, die aktualisiert werden muss. Der dritte Befehl legt die private IP-Adresse der primären IP-Konfiguration ipconfig1 auf 10.0.0.11 fest. Schließlich aktualisiert der letzte Befehl die Netzwerkschnittstelle, um sicherzustellen, dass die Änderungen erfolgreich vorgenommen wurden.

Beispiel 2: Zuordnen einer IP-Konfiguration zu einer Anwendungssicherheitsgruppe

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary

$nic | Set-AzNetworkInterface

In diesem Beispiel enthält die Variable $asg einen Verweis auf eine Anwendungssicherheitsgruppe. Der vierte Befehl ruft die Netzwerkschnittstelle nic1 ab, die der IP-Konfiguration zugeordnet ist, die aktualisiert werden muss. Die Set-AzNetworkInterfaceIpConfig legt die private IP-Adresse der primären IP-Konfiguration ipconfig1 auf 10.0.0.11 fest und erstellt eine Zuordnung mit der abgerufenen Anwendungssicherheitsgruppe. Schließlich aktualisiert der letzte Befehl die Netzwerkschnittstelle, um sicherzustellen, dass die Änderungen erfolgreich vorgenommen wurden.

Beispiel 3: Aufheben der Zuordnung einer IP-Konfiguration zu einem Anwendungsgateway-Back-End-Adresspool

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null

$nic | Set-AzNetworkInterface

Mit dem Set-AzNetworkInterfaceIpConfig wird der Back-End-Adresspool des Anwendungsgateways der IP-Konfigurations-IPconfig1 auf NULL festgelegt und die Zuordnung zur Netzwerkschnittstelle aufgehoben. Schließlich aktualisiert der letzte Befehl die Netzwerkschnittstelle, um sicherzustellen, dass die Änderungen erfolgreich vorgenommen wurden.

Parameter

-ApplicationGatewayBackendAddressPool

Gibt eine Auflistung von Verweisen auf den Back-End-Adresspool des Anwendungsgateways an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

PSApplicationGatewayBackendAddressPool[]

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

Parametersätze

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

-ApplicationGatewayBackendAddressPoolId

Gibt eine Auflistung von Verweisen auf den Back-End-Adresspool des Anwendungsgateways an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

String[]

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

Parametersätze

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

-ApplicationSecurityGroup

Gibt eine Auflistung von Anwendungssicherheitsgruppenverweisen an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

PSApplicationSecurityGroup[]

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

Parametersätze

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

-ApplicationSecurityGroupId

Gibt eine Auflistung von Anwendungssicherheitsgruppenverweisen an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

String[]

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

Parametersätze

SetByResourceId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
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

-GatewayLoadBalancerId

Gibt die ID der Front-Ip-Konfiguration des Gateway-Lastenausgleichsanbieters an.

Parametereigenschaften

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

Parametersätze

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

-LoadBalancerBackendAddressPool

Gibt eine Auflistung von Back-End-Adresspoolreferenzen für das Lastenausgleichsmodul an, zu der diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

PSBackendAddressPool[]

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

Parametersätze

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

-LoadBalancerBackendAddressPoolId

Gibt eine Auflistung von Back-End-Adresspoolreferenzen für das Lastenausgleichsmodul an, zu der diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

String[]

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

Parametersätze

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

-LoadBalancerInboundNatRule

Gibt eine Auflistung von NAT-Regeln (Load Balancer) an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

PSInboundNatRule[]

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

Parametersätze

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

-LoadBalancerInboundNatRuleId

Gibt eine Auflistung eingehender NAT-Regelverweise an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Parametereigenschaften

Typ:

String[]

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

Parametersätze

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

-Name

Gibt den Namen der Netzwerk-IP-Konfiguration an, für die dieses Cmdlet festgelegt wird.

Parametereigenschaften

Typ:String
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

-NetworkInterface

Gibt ein NetworkInterface - Objekt an. Dieses Cmdlet fügt dem Objekt, das dieser Parameter angibt, eine IP-Konfiguration der Netzwerkschnittstelle hinzu.

Parametereigenschaften

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

Parametersätze

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

-Primary

Das Cmdlet Set-AzNetworkInterfaceIpConfig aktualisiert eine IP-Konfiguration für eine Netzwerkschnittstelle.

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

-PrivateIpAddress

Gibt die statische IP-Adresse der IP-Konfiguration der Netzwerkschnittstelle an.

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

-PrivateIpAddressVersion

Gibt die IP-Adressversion einer IP-Konfiguration der Netzwerkschnittstelle an. Die zulässigen Werte für diesen Parameter sind:

  • IPv4
  • IPv6

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:IPv4, IPv6
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

-PublicIpAddress

Gibt ein PublicIPAddress - Objekt an. Dieses Cmdlet erstellt einen Verweis auf eine öffentliche IP-Adresse, die dieser IP-Konfiguration der Netzwerkschnittstelle zugeordnet werden soll.

Parametereigenschaften

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

Parametersätze

SetByResource
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PublicIpAddressId

Dieses Cmdlet erstellt einen Verweis auf eine öffentliche IP-Adresse, die dieser IP-Konfiguration der Netzwerkschnittstelle zugeordnet werden soll.

Parametereigenschaften

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

Parametersätze

SetByResourceId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Subnet

Gibt ein Subnetzobjekt an. Dieses Cmdlet erstellt einen Verweis auf ein Subnetz, in dem diese IP-Konfiguration der Netzwerkschnittstelle erstellt wird.

Parametereigenschaften

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

Parametersätze

SetByResource
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubnetId

Dieses Cmdlet erstellt einen Verweis auf ein Subnetz, in dem diese IP-Konfiguration der Netzwerkschnittstelle erstellt wird.

Parametereigenschaften

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

Parametersätze

SetByResourceId
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

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Ausgaben

PSNetworkInterface

Hinweise

  • Schlüsselwörter: azure, azurerm, arm, resource, management, manager, network, networking