Dela via

Set-AzNetworkInterfaceIpConfig

  • Referens
Modul:
Az.Network

Uppdaterar en IP-konfiguration för ett nätverksgränssnitt.

Syntax

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

Cmdleten Set-AzNetworkInterfaceIpConfig uppdaterar en IP-konfiguration för ett nätverksgränssnitt.

Exempel

Exempel 1: Ändra IP-adressen för en 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

De första två kommandona hämtar ett virtuellt nätverk med namnet myvnet och ett undernät med namnet mysubnet och lagrar det i variablerna $vnet respektive $subnet. Det tredje kommandot hämtar nätverksgränssnittet nic1 som är associerat med DEN IP-konfiguration som måste uppdateras. Det tredje kommandot anger den privata IP-adressen för den primära IP-konfigurationen ipconfig1 till 10.0.0.11. Slutligen uppdaterar det senaste kommandot nätverksgränssnittet så att ändringarna har gjorts.

Exempel 2: Associera en IP-konfiguration med en programsäkerhetsgrupp

$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

I det här exemplet innehåller variabeln $asg en referens till en programsäkerhetsgrupp. Det fjärde kommandot hämtar nätverksgränssnittet nic1 som är associerat med DEN IP-konfiguration som måste uppdateras. Set-AzNetworkInterfaceIpConfig anger den privata IP-adressen för den primära IP-konfigurationen ipconfig1 till 10.0.0.11 och skapar en association med den hämtade programsäkerhetsgruppen. Slutligen uppdaterar det senaste kommandot nätverksgränssnittet så att ändringarna har gjorts.

Exempel 3: Koppla bort en IP-konfiguration med en serverdelsadresspool för programgateway

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

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

$nic | Set-AzNetworkInterface

Set-AzNetworkInterfaceIpConfig anger application gateway-serverdelsadresspoolen för IP-konfigurationen ipconfig1 till null och kopplar från nätverksgränssnittet. Slutligen uppdaterar det senaste kommandot nätverksgränssnittet så att ändringarna har gjorts.

Parametrar

-ApplicationGatewayBackendAddressPool

Anger en samling referenser till serverdelsadresspoolen för application gateway som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:PSApplicationGatewayBackendAddressPool[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ApplicationGatewayBackendAddressPoolId

Anger en samling referenser till serverdelsadresspoolen för application gateway som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ApplicationSecurityGroup

Anger en samling programsäkerhetsgruppreferenser som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:PSApplicationSecurityGroup[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ApplicationSecurityGroupId

Anger en samling programsäkerhetsgruppreferenser som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GatewayLoadBalancerId

Anger ID:t för Gateway Load Balancer Provider Frontend Ip Configuration.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LoadBalancerBackendAddressPool

Anger en samling referenser för lastbalanserarens serverdelsadresspool som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:PSBackendAddressPool[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LoadBalancerBackendAddressPoolId

Anger en samling referenser för lastbalanserarens serverdelsadresspool som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LoadBalancerInboundNatRule

Anger en samling nat-regelreferenser (inbound network address translation) för lastbalanserare som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:PSInboundNatRule[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LoadBalancerInboundNatRuleId

Anger en samling inkommande NAT-regelreferenser för lastbalanserare som ip-konfigurationen för nätverksgränssnittet tillhör.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på nätverks-IP-konfigurationen som den här cmdleten anger för.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NetworkInterface

Anger ett NetworkInterface-objekt . Den här cmdleten lägger till en IP-konfiguration för nätverksgränssnittet till det objekt som den här parametern anger.

Typ:PSNetworkInterface
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Primary

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrivateIpAddress

Anger den statiska IP-adressen för IP-konfigurationen för nätverksgränssnittet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrivateIpAddressVersion

Anger IP-adressversionen för en IP-konfiguration för nätverksgränssnittet. De acceptabla värdena för den här parametern är:

  • IPv4
  • IPv6
Typ:String
Godkända värden:IPv4, IPv6
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIpAddress

Anger ett PublicIPAddress-objekt . Den här cmdleten skapar en referens till en offentlig IP-adress som ska associeras med den här IP-konfigurationen för nätverksgränssnittet.

Typ:PSPublicIpAddress
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIpAddressId

Den här cmdleten skapar en referens till en offentlig IP-adress som ska associeras med den här IP-konfigurationen för nätverksgränssnittet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Subnet

Anger ett undernätsobjekt . Den här cmdleten skapar en referens till ett undernät där ip-konfigurationen för nätverksgränssnittet skapas.

Typ:PSSubnet
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubnetId

Den här cmdleten skapar en referens till ett undernät där ip-konfigurationen för nätverksgränssnittet skapas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Utdata

PSNetworkInterface

Kommentarer

  • Nyckelord: azure, azurerm, arm, resource, management, manager, network, networking