Delen via

New-AzNetworkInterfaceIpConfig

Module:
Az.Network Module

Hiermee maakt u een IP-configuratie van de netwerkinterface.

Syntaxis

SetByResource (Standaard) 

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

SetByResourceId 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

De cmdlet New-AzNetworkInterfaceIpConfig maakt een IP-configuratie van de Azure-netwerkinterface voor een netwerkinterface.

Voorbeelden

Voorbeeld 1: Een IP-configuratie maken met een openbaar IP-adres voor een netwerkinterface

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1 -Primary

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig1

De eerste twee opdrachten krijgen een virtueel netwerk met de naam myvnet en een subnet met de naam mysubnet dat eerder is gemaakt. Deze worden respectievelijk opgeslagen in $vnet en $Subnet. Met de derde opdracht krijgt u een eerder gemaakt openbaar IP-adres met de naam PIP1. Met de volgende opdracht maakt u een nieuwe IP-configuratie met de naam IPConfig-1 als primaire IP-configuratie met een openbaar IP-adres dat eraan is gekoppeld. Met de laatste opdracht maakt u vervolgens een netwerkinterface met de naam mynic1 met behulp van deze IP-configuratie.

Voorbeeld 2: Een IP-configuratie maken met een privé-IP-adres

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

$IPConfig2 = New-AzNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress 10.0.0.5

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig2

De eerste twee opdrachten krijgen een virtueel netwerk met de naam myvnet en een subnet met de naam mysubnet dat eerder is gemaakt. Deze worden respectievelijk opgeslagen in $vnet en $Subnet. Met de derde opdracht maakt u een nieuwe IP-configuratie met de naam IPConfig-2 met een privé-IP-adres 10.0.0.5 dat eraan is gekoppeld. Met de laatste opdracht maakt u vervolgens een netwerkinterface met de naam mynic1 met behulp van deze IP-configuratie.

Voorbeeld 3

Hiermee maakt u een IP-configuratie van de netwerkinterface. (autogenerated)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

Parameters

-ApplicationGatewayBackendAddressPool

Hiermee geeft u een verzameling back-endadresgroep van application gateway verwijzingen waarnaar deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

PSApplicationGatewayBackendAddressPool[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationGatewayBackendAddressPoolId

Hiermee geeft u een verzameling back-endadresgroep van application gateway verwijzingen waarnaar deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationSecurityGroup

Hiermee geeft u een verzameling toepassingsbeveiligingsgroepverwijzingen op waartoe deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

PSApplicationSecurityGroup[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationSecurityGroupId

Hiermee geeft u een verzameling toepassingsbeveiligingsgroepverwijzingen op waartoe deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-GatewayLoadBalancerId

De verwijzing naar de Gateway LoadBalancer Provider-resource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerBackendAddressPool

Hiermee geeft u een verzameling back-endadresgroepverwijzingen van load balancer waarnaar deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

PSBackendAddressPool[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerBackendAddressPoolId

Hiermee geeft u een verzameling back-endadresgroepverwijzingen van load balancer waarnaar deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerInboundNatRule

Hiermee geeft u een verzameling inkomende Nat-regelverwijzingen voor load balancer op waartoe deze IPConfiguration-netwerkinterface behoort.

Parametereigenschappen

Type:

PSInboundNatRule[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerInboundNatRuleId

Hiermee geeft u een verzameling van binnenkomende NAT-regels (Network Address Translation) voor load balancer op waarnaar deze IP-configuratie van de netwerkinterface behoort.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam van de IP-configuratie van de netwerkinterface.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Primary

De cmdlet New-AzNetworkInterfaceIpConfig maakt een IP-configuratie van de Azure-netwerkinterface voor een netwerkinterface.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrivateIpAddress

Hiermee geeft u het statische IP-adres van de IP-configuratie van de netwerkinterface.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrivateIPAddressPrefixLength

Hiermee geeft u de lengte van het statische IP-adresvoorvoegsel van de IP-configuratie van de netwerkinterface.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrivateIpAddressVersion

Hiermee geeft u de IP-adresversie van een IP-configuratie van een netwerkinterface. De acceptabele waarden voor deze parameter zijn:

  • IPv4
  • IPv6

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:IPv4, IPv6
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PublicIpAddress

Hiermee geeft u een PublicIPAddress-object . Met deze cmdlet wordt een verwijzing gemaakt naar een openbaar IP-adres dat moet worden gekoppeld aan deze IP-configuratie van de netwerkinterface.

Parametereigenschappen

Type:PSPublicIpAddress
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PublicIpAddressId

Met deze cmdlet wordt een verwijzing gemaakt naar een openbaar IP-adres dat moet worden gekoppeld aan deze IP-configuratie van de netwerkinterface.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Subnet

Hiermee geeft u een Subnet-object . Met deze cmdlet maakt u een verwijzing naar een subnet waarin deze IP-configuratie van de netwerkinterface wordt gemaakt.

Parametereigenschappen

Type:PSSubnet
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SubnetId

Hiermee geeft u een verwijzing naar een subnet waarin deze IP-configuratie van de netwerkinterface wordt gemaakt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Uitvoerwaarden

PSNetworkInterfaceIPConfiguration

Notities

  • Trefwoorden: azurerm, arm, resource, beheer, manager, netwerk, netwerken