Set-AzNetworkInterfaceIpConfig
Uppdateringar en IP-konfiguration för ett nätverksgränssnitt.
Syntax
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>]
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
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.
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.
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
Set-AzNetworkInterfaceIpConfig anger application gateway-serverdelsadresspoolen för IP-konfigurationen ipconfig1 till null och kopplar 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.
Type: | PSApplicationGatewayBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationGatewayBackendAddressPoolId
Anger en samling referenser till serverdelsadresspoolen för application gateway som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationSecurityGroup
Anger en samling programsäkerhetsgruppreferenser som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | PSApplicationSecurityGroup[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationSecurityGroupId
Anger en samling programsäkerhetsgruppreferenser som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewayLoadBalancerId
Anger ID:t för Gateway Load Balancer Provider Frontend Ip Configuration.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerBackendAddressPool
Anger en samling referenser för lastbalanserarens serverdelsadresspool som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | PSBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerBackendAddressPoolId
Anger en samling referenser för lastbalanserarens serverdelsadresspool som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerInboundNatRule
Anger en samling nat-regelreferenser (inbound network address translation) för lastbalanserare som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | PSInboundNatRule[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerInboundNatRuleId
Anger en samling inkommande NAT-regelreferenser för lastbalanserare som ip-konfigurationen för nätverksgränssnittet tillhör.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Anger namnet på nätverks-IP-konfigurationen som den här cmdleten anger för.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSNetworkInterface |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Primary
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateIpAddress
Anger den statiska IP-adressen för IP-konfigurationen för nätverksgränssnittet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | String |
Accepted values: | IPv4, IPv6 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSPublicIpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSSubnet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetId
Den här cmdleten skapar en referens till ett undernät där ip-konfigurationen för nätverksgränssnittet skapas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
String[]
PSApplicationGatewayBackendAddressPool[]
Utdata
Kommentarer
- Nyckelord: azure, azurerm, arm, resource, management, manager, network, networking