Set-AzureRmNetworkInterfaceIpConfig

  • Referens
Modul:
AzureRM.Network

Anger måltillståndet för en IP-konfiguration för Azure-nätverksgränssnittet.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Cmdleten Set-AzureRmNetworkInterfaceIpConfig anger måltillståndet för en IP-konfiguration för Azure-nätverksgränssnittet.

Exempel

1: Ändra IP-adressen för en IP-konfiguration

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

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

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

$nic | Set-AzureRmNetworkInterface

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.

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

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

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

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

$nic | Set-AzureRmNetworkInterface

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-AzureRmNetworkInterfaceIpConfig 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.

Parametrar

-ApplicationGatewayBackendAddressPool

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

Typ:List<T>[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:List<T>[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:List<T>[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:List<T>[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:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LoadBalancerBackendAddressPool

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

Typ:List<T>[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:List<T>[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:List<T>[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:List<T>[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

Parametrar: NetworkInterface (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Utdata

PSNetworkInterface

Kommentarer

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