Bagikan melalui


New-AzNetworkInterface

Membuat antarmuka jaringan.

Sintaks

SetByIpConfigurationResource (Default)

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
    [-EdgeZone <String>]
    [-DnsServer <String[]>]
    [-InternalDnsNameLabel <String>]
    [-DisableTcpStateTracking <String>]
    [-EnableIPForwarding]
    [-EnableAcceleratedNetworking]
    [-AuxiliaryMode <String>]
    [-AuxiliarySku <String>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByIpConfigurationResourceId

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
    [-EdgeZone <String>]
    [-NetworkSecurityGroupId <String>]
    [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
    [-DnsServer <String[]>]
    [-InternalDnsNameLabel <String>]
    [-DisableTcpStateTracking <String>]
    [-EnableIPForwarding]
    [-EnableAcceleratedNetworking]
    [-AuxiliaryMode <String>]
    [-AuxiliarySku <String>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceId

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -SubnetId <String>
    [-EdgeZone <String>]
    [-PublicIpAddressId <String>]
    [-NetworkSecurityGroupId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-PrivateIpAddress <String>]
    [-IpConfigurationName <String>]
    [-DnsServer <String[]>]
    [-InternalDnsNameLabel <String>]
    [-DisableTcpStateTracking <String>]
    [-EnableIPForwarding]
    [-EnableAcceleratedNetworking]
    [-AuxiliaryMode <String>]
    [-AuxiliarySku <String>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResource

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -Subnet <PSSubnet>
    [-EdgeZone <String>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-PrivateIpAddress <String>]
    [-IpConfigurationName <String>]
    [-DnsServer <String[]>]
    [-InternalDnsNameLabel <String>]
    [-DisableTcpStateTracking <String>]
    [-EnableIPForwarding]
    [-EnableAcceleratedNetworking]
    [-AuxiliaryMode <String>]
    [-AuxiliarySku <String>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet New-AzNetworkInterface membuat antarmuka jaringan Azure.

Contoh

Contoh 1: Membuat antarmuka jaringan Azure

New-AzNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1" -IpConfigurationName "IPConfiguration1" -DnsServer "8.8.8.8", "8.8.4.4"

Perintah ini membuat antarmuka jaringan bernama NetworkInterface001 dengan alamat IP privat yang ditetapkan secara dinamis dari Subnet1 di jaringan virtual bernama VirtualNetwork1. Perintah ini juga menetapkan dua server DNS ke antarmuka jaringan. Sumber daya anak IPConfiguration akan dibuat secara otomatis menggunakan nama IPConfiguration1.

Contoh 2: Membuat antarmuka jaringan Azure menggunakan objek konfigurasi IP

$Subnet = Get-AzVirtualNetwork -Name "VirtualNetwork1" -ResourceGroupName "ResourceGroup1"
$IPconfig = New-AzNetworkInterfaceIpConfig -Name "IPConfig1" -PrivateIpAddressVersion IPv4 -PrivateIpAddress "10.0.1.10" -SubnetId $Subnet.Subnets[0].Id
New-AzNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -IpConfiguration $IPconfig

Contoh ini membuat antarmuka jaringan baru menggunakan objek konfigurasi IP. Objek konfigurasi IP menentukan alamat IPv4 privat statis. Perintah pertama mengambil jaringan virtual yang ditentukan yang ada yang digunakan untuk menetapkan subnet di perintah kedua. Perintah kedua membuat konfigurasi IP antarmuka jaringan bernama IPConfig1 dan menyimpan konfigurasi dalam variabel bernama $IPconfig. Perintah ketiga membuat antarmuka jaringan bernama NetworkInterface1 yang menggunakan konfigurasi IP antarmuka jaringan yang disimpan dalam variabel bernama $IPconfig.

Contoh 3

Membuat antarmuka jaringan. (autogenerated)

New-AzNetworkInterface -Location 'West US' -Name 'NetworkInterface1' -PrivateIpAddress '10.0.1.10' -ResourceGroupName 'ResourceGroup1' -SubnetId '/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1'

Parameter

-ApplicationGatewayBackendAddressPool

Menentukan objek ApplicationGatewayBackendAddressPool .

Properti parameter

Jenis:

PSApplicationGatewayBackendAddressPool[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ApplicationGatewayBackendAddressPoolId

Menentukan ID objek ApplicationGatewayBackendAddressPool .

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ApplicationSecurityGroup

Menentukan kumpulan referensi grup keamanan aplikasi tempat konfigurasi IP antarmuka jaringan harus dimiliki.

Properti parameter

Jenis:

PSApplicationSecurityGroup[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ApplicationSecurityGroupId

Menentukan kumpulan referensi grup keamanan aplikasi tempat konfigurasi IP antarmuka jaringan harus dimiliki.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-AsJob

Jalankan cmdlet di latar belakang

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-AuxiliaryMode

Mode tambahan antarmuka jaringan

Properti parameter

Jenis:String
Nilai default:None
Nilai yang diterima:None, MaxConnections, AcceleratedConnections, Floating
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-AuxiliarySku

Sku tambahan antarmuka jaringan

Properti parameter

Jenis:String
Nilai default:None
Nilai yang diterima:None, A1, A2, A4, A8
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Properti parameter

Jenis:IAzureContextContainer
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DisableTcpStateTracking

Menunjukkan apakah akan menonaktifkan pelacakan status tcp.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-DnsServer

Menentukan server DNS untuk antarmuka jaringan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-EdgeZone

Zona tepi antarmuka jaringan

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-EnableAcceleratedNetworking

Mengaktifkan jaringan yang dipercepat.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-EnableIPForwarding

Menunjukkan bahwa cmdlet ini memungkinkan penerusan IP untuk antarmuka jaringan. Penerusan IP memungkinkan komputer virtual untuk menerima lalu lintas yang ditujukan ke tujuan lain.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Memaksa pembuatan antarmuka jaringan bahkan jika antarmuka jaringan dengan nama yang sama sudah ada.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-InternalDnsNameLabel

Menentukan label nama DNS internal untuk antarmuka jaringan baru.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-IpConfiguration

Menentukan konfigurasi IP yang digunakan cmdlet ini untuk antarmuka jaringan.

Properti parameter

Jenis:

PSNetworkInterfaceIPConfiguration[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByIpConfigurationResource
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
SetByIpConfigurationResourceId
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-IpConfigurationName

Menentukan nama konfigurasi IP.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-LoadBalancerBackendAddressPool

Menentukan objek BackendAddressPool .

Properti parameter

Jenis:

PSBackendAddressPool[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-LoadBalancerBackendAddressPoolId

Menentukan ID objek BackendAddressPool .

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-LoadBalancerInboundNatRule

Menentukan konfigurasi aturan NAT masuk untuk load balancer.

Properti parameter

Jenis:

PSInboundNatRule[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-LoadBalancerInboundNatRuleId

Menentukan ID konfigurasi aturan NAT masuk untuk load balancer.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Location

Menentukan wilayah untuk antarmuka jaringan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama antarmuka jaringan yang akan dibuat.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Nama Sumber

Set parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-NetworkSecurityGroup

Menentukan objek NetworkSecurityGroup .

Properti parameter

Jenis:PSNetworkSecurityGroup
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByIpConfigurationResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-NetworkSecurityGroupId

Menentukan ID grup keamanan jaringan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByIpConfigurationResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PrivateIpAddress

Menentukan alamat IP IPv4 statis untuk ditetapkan ke antarmuka jaringan ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PublicIpAddress

Menentukan objek PublicIPAddress untuk ditetapkan ke antarmuka jaringan.

Properti parameter

Jenis:PSPublicIpAddress
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PublicIpAddressId

Menentukan ID objek PublicIPAddress untuk ditetapkan ke antarmuka jaringan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ResourceGroupName

Menentukan nama grup sumber daya tempat antarmuka jaringan berada.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Subnet

Menentukan objek Subnet . Cmdlet ini membuat antarmuka jaringan untuk subnet yang ditentukan parameter ini.

Properti parameter

Jenis:PSSubnet
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResource
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-SubnetId

Menentukan ID subnet untuk membuat antarmuka jaringan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

SetByResourceId
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Tag

Pasangan kunci-nilai dalam bentuk tabel hash. Misalnya: @{key0="value0"; key1=$null; key2="value2"}

Properti parameter

Jenis:Hashtable
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

PSNetworkInterfaceIPConfiguration

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Hashtable

Output

PSNetworkInterface