Set-AzNetworkInterfaceIpConfig

Modul:

Az.Network Module

Frissíti a hálózati adapter IP-konfigurációját.

Syntax

SetByResource (Alapértelmezett)

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

Description

A Set-AzNetworkInterfaceIpConfig parancsmag frissíti a hálózati adapter IP-konfigurációját.

Példák

1. példa: Ip-konfiguráció IP-címének módosítása

$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

Az első két parancs lekér egy myvnet nevű virtuális hálózatot és egy mysubnet nevű alhálózatot, és tárolja azt az $vnet és $subnet változókban. A harmadik parancs lekéri a frissíteni kívánt IP-konfigurációhoz társított hálózati adapter nic1-et. A harmadik parancs az elsődleges IP-konfiguráció ipconfig1 privát IP-címét 10.0.0.11-re állítja. Végül az utolsó parancs frissíti a hálózati adaptert, biztosítva, hogy a módosítások sikeresek legyenek.

2. példa: IP-konfiguráció társítása egy alkalmazásbiztonsági csoporttal

$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

Ebben a példában a $asg változó egy alkalmazásbiztonsági csoportra mutató hivatkozást tartalmaz. A negyedik parancs lekéri a frissíteni kívánt IP-konfigurációhoz társított hálózati adapter nic1-et. A Set-AzNetworkInterfaceIpConfig beállítja az elsődleges IP-konfiguráció ipconfig1 privát IP-címét 10.0.0.11-re, és létrehoz egy társításokat a lekért alkalmazásbiztonsági csoporttal. Végül az utolsó parancs frissíti a hálózati adaptert, biztosítva, hogy a módosítások sikeresek legyenek.

3. példa: IP-konfiguráció társítása az Application Gateway háttércímkészletével

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

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

$nic | Set-AzNetworkInterface

A Set-AzNetworkInterfaceIpConfig az IP-konfigurációs ipconfig1 alkalmazásátjáró háttércímkészletét null értékűre állítja, és leválasztja a hálózati adapterről. Végül az utolsó parancs frissíti a hálózati adaptert, biztosítva, hogy a módosítások sikeresek legyenek.

Paraméterek

-ApplicationGatewayBackendAddressPool

Az Application Gateway háttércímkészlet-hivatkozásainak gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	PSApplicationGatewayBackendAddressPool[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ApplicationGatewayBackendAddressPoolId

Az Application Gateway háttércímkészlet-hivatkozásainak gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResourceId

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ApplicationSecurityGroup

Alkalmazásbiztonsági csoporthivatkozások gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	PSApplicationSecurityGroup[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ApplicationSecurityGroupId

Alkalmazásbiztonsági csoporthivatkozások gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResourceId

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:	IAzureContextContainer
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	AzContext, AzureRmContext, AzureCredential

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-GatewayLoadBalancerId

Megadja az átjáró load Balancer-szolgáltató előtérbeli IP-konfigurációjának azonosítóját.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-LoadBalancerBackendAddressPool

A terheléselosztó háttércímkészletére mutató hivatkozások gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	PSBackendAddressPool[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-LoadBalancerBackendAddressPoolId

A terheléselosztó háttércímkészletére mutató hivatkozások gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResourceId

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-LoadBalancerInboundNatRule

A terheléselosztó bejövő hálózati címfordítási (NAT) szabályhivatkozásainak gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	PSInboundNatRule[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-LoadBalancerInboundNatRuleId

A terheléselosztó bejövő NAT-szabályhivatkozásainak gyűjteményét adja meg, amelyhez ez a hálózati adapter IP-konfigurációja tartozik.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResourceId

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

Annak a hálózati IP-konfigurációnak a nevét adja meg, amelyhez ez a parancsmag beállít.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-NetworkInterface

NetworkInterface objektumot ad meg. Ez a parancsmag hozzáad egy hálózati adapter IP-konfigurációt a paraméter által megadott objektumhoz.

Paramétertulajdonságok

Típus:	PSNetworkInterface
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Primary

A Set-AzNetworkInterfaceIpConfig parancsmag frissíti a hálózati adapter IP-konfigurációját.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PrivateIpAddress

Megadja a hálózati adapter IP-konfigurációjának statikus IP-címét.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PrivateIpAddressVersion

A hálózati adapter IP-címkonfigurációjának IP-címverzióját adja meg. A paraméter elfogadható értékei a következők:

• IPv4
• IPv6

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Elfogadott értékek:	IPv4, IPv6
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PublicIpAddress

Egy PublicIPAddress objektumot határoz meg. Ez a parancsmag létrehoz egy hivatkozást egy nyilvános IP-címre a hálózati adapter IP-konfigurációjának társításához.

Paramétertulajdonságok

Típus:	PSPublicIpAddress
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PublicIpAddressId

Ez a parancsmag létrehoz egy hivatkozást egy nyilvános IP-címre a hálózati adapter IP-konfigurációjának társításához.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResourceId

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Subnet

Alhálózati objektumot ad meg. Ez a parancsmag egy olyan alhálózatra mutató hivatkozást hoz létre, amelyben ez a hálózati adapter IP-konfigurációja létrejön.

Paramétertulajdonságok

Típus:	PSSubnet
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResource

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-SubnetId

Ez a parancsmag egy olyan alhálózatra mutató hivatkozást hoz létre, amelyben ez a hálózati adapter IP-konfigurációja létrejön.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SetByResourceId

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Kimenetek

PSNetworkInterface

Jegyzetek

• Kulcsszavak: azure, azurerm, arm, erőforrás, felügyelet, vezető, hálózat, hálózatkezelés

Kapcsolódó hivatkozások

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• New-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig