Aracılığıyla paylaş


Set-AzNetworkInterfaceIpConfig

Bir ağ arabirimi için IP yapılandırmasını güncelleştirir.

Syntax

SetByResource (Varsayılan)

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

Set-AzNetworkInterfaceIpConfig cmdlet'i bir ağ arabirimi için IP yapılandırmasını güncelleştirir.

Örnekler

Örnek 1: IP yapılandırmasının IP adresini değiştirme

$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

İlk iki komut, myvnet adlı bir sanal ağı ve mysubnet adlı bir alt ağı alır ve sırasıyla $vnet ve $subnet değişkenlerinde depolar. Üçüncü komut, güncelleştirilmesi gereken IP yapılandırmasıyla ilişkili ağ arabirimi nic1'i alır. Üçüncü komut, birincil IP yapılandırması ipconfig1'in özel IP adresini 10.0.0.11 olarak ayarlar. Son olarak, son komut, değişikliklerin başarıyla yapıldığından emin olarak ağ arabirimini güncelleştirir.

Örnek 2: IP yapılandırmasını bir uygulama güvenlik grubuyla ilişkilendirme

$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

Bu örnekte, $asg değişkeni bir uygulama güvenlik grubuna başvuru içerir. Dördüncü komut, güncelleştirilmesi gereken IP yapılandırmasıyla ilişkili ağ arabirimi nic1'i alır. Set-AzNetworkInterfaceIpConfig, birincil IP yapılandırması ipconfig1'in özel IP adresini 10.0.0.11 olarak ayarlar ve alınan uygulama güvenlik grubuyla bir ilişkilendirme oluşturur. Son olarak, son komut, değişikliklerin başarıyla yapıldığından emin olarak ağ arabirimini güncelleştirir.

Örnek 3: Ip yapılandırmasını uygulama ağ geçidi arka uç adres havuzuyla ilişkilendirme

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

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

$nic | Set-AzNetworkInterface

Set-AzNetworkInterfaceIpConfig IP yapılandırması ipconfig1'in uygulama ağ geçidi arka uç adres havuzunu null olarak ayarlar ve ağ arabirimiyle ilişkilendirilmez. Son olarak, son komut, değişikliklerin başarıyla yapıldığından emin olarak ağ arabirimini güncelleştirir.

Parametreler

-ApplicationGatewayBackendAddressPool

Bu ağ arabirimi IP yapılandırmasının ait olduğu uygulama ağ geçidi arka uç adres havuzu başvurularının bir koleksiyonunu belirtir.

Parametre özellikleri

Tür:

PSApplicationGatewayBackendAddressPool[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ApplicationGatewayBackendAddressPoolId

Bu ağ arabirimi IP yapılandırmasının ait olduğu uygulama ağ geçidi arka uç adres havuzu başvurularının bir koleksiyonunu belirtir.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ApplicationSecurityGroup

Bu ağ arabirimi IP yapılandırmasının ait olduğu uygulama güvenlik grubu başvurularının bir koleksiyonunu belirtir.

Parametre özellikleri

Tür:

PSApplicationSecurityGroup[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ApplicationSecurityGroupId

Bu ağ arabirimi IP yapılandırmasının ait olduğu uygulama güvenlik grubu başvurularının bir koleksiyonunu belirtir.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-GatewayLoadBalancerId

Ağ Geçidi Yük Dengeleyici Sağlayıcısı Ön Uç Ip Yapılandırmasının kimliğini belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-LoadBalancerBackendAddressPool

Bu ağ arabirimi IP yapılandırmasının ait olduğu yük dengeleyici arka uç adres havuzu başvurularından oluşan bir koleksiyonu belirtir.

Parametre özellikleri

Tür:

PSBackendAddressPool[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-LoadBalancerBackendAddressPoolId

Bu ağ arabirimi IP yapılandırmasının ait olduğu yük dengeleyici arka uç adres havuzu başvurularından oluşan bir koleksiyonu belirtir.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-LoadBalancerInboundNatRule

Bu ağ arabirimi IP yapılandırmasının ait olduğu yük dengeleyici gelen ağ adresi çevirisi (NAT) kural başvurularından oluşan bir koleksiyonu belirtir.

Parametre özellikleri

Tür:

PSInboundNatRule[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-LoadBalancerInboundNatRuleId

Bu ağ arabirimi IP yapılandırmasının ait olduğu yük dengeleyici gelen NAT kuralı başvurularının koleksiyonunu belirtir.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

Bu cmdlet'in ayarlandığı ağ IP yapılandırmasının adını belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-NetworkInterface

NetworkInterface nesnesini belirtir. Bu cmdlet, bu parametrenin belirttiği nesneye bir ağ arabirimi IP yapılandırması ekler.

Parametre özellikleri

Tür:PSNetworkInterface
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Primary

Set-AzNetworkInterfaceIpConfig cmdlet'i bir ağ arabirimi için IP yapılandırmasını güncelleştirir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-PrivateIpAddress

Ağ arabirimi IP yapılandırmasının statik IP adresini belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-PrivateIpAddressVersion

Ağ arabirimi IP yapılandırmasının IP adresi sürümünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • IPv4
  • IPv6

Parametre özellikleri

Tür:String
Default value:None
Kabul edilen değerler:IPv4, IPv6
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-PublicIpAddress

PublicIPAddress nesnesini belirtir. Bu cmdlet, bu ağ arabirimi IP yapılandırmasıyla ilişkilendirilecek bir genel IP Adresine başvuru oluşturur.

Parametre özellikleri

Tür:PSPublicIpAddress
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-PublicIpAddressId

Bu cmdlet, bu ağ arabirimi IP yapılandırmasıyla ilişkilendirilecek bir genel IP Adresine başvuru oluşturur.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Subnet

Alt ağ nesnesini belirtir. Bu cmdlet, bu ağ arabirimi IP yapılandırmasının oluşturulduğu bir alt ağa başvuru oluşturur.

Parametre özellikleri

Tür:PSSubnet
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResource
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-SubnetId

Bu cmdlet, bu ağ arabirimi IP yapılandırmasının oluşturulduğu bir alt ağa başvuru oluşturur.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

SetByResourceId
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Çıkışlar

PSNetworkInterface

Notlar

  • Anahtar sözcükler: azure, azurerm, arm, kaynak, yönetim, yönetici, ağ, ağ