Dela via

Set-AzNetworkInterfaceIpConfig

Modul:
Az.Network Module

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

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

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

I Set-AzNetworkInterfaceIpConfig anges application gateway-serverdelsadresspoolen för IP-konfigurationen ipconfig1 till null och kopplas 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.

Parameteregenskaper

Typ:

PSApplicationGatewayBackendAddressPool[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationGatewayBackendAddressPoolId

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationSecurityGroup

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

Parameteregenskaper

Typ:

PSApplicationSecurityGroup[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationSecurityGroupId

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-GatewayLoadBalancerId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerBackendAddressPool

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

Parameteregenskaper

Typ:

PSBackendAddressPool[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerBackendAddressPoolId

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerInboundNatRule

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

Parameteregenskaper

Typ:

PSInboundNatRule[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerInboundNatRuleId

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:PSNetworkInterface
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Primary

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PrivateIpAddress

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:IPv4, IPv6
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:PSPublicIpAddress
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:PSSubnet
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SubnetId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Utdata

PSNetworkInterface

Kommentarer

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