Set-AzNetworkInterfaceIpConfig
Mises à jour une configuration IP pour une interface réseau.
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
L’applet de commande Set-AzNetworkInterfaceIpConfig met à jour une configuration IP pour une interface réseau.
Exemples
1 : Modification de l’adresse IP d’une configuration IP
$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
Les deux premières commandes obtiennent un réseau virtuel appelé myvnet et un sous-réseau appelé mysubnet et stockent-le dans les variables $vnet et $subnet respectivement. La troisième commande obtient la carte réseau nic1 associée à la configuration IP qui doit être mise à jour. La troisième commande définit l’adresse IP privée de l’ipconfig1 de configuration IP principale sur 10.0.0.11. Enfin, la dernière commande met à jour l’interface réseau pour s’assurer que les modifications ont été apportées avec succès.
2 : Association d’une configuration IP à un groupe de sécurité d’application
$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
Dans cet exemple, la variable $asg contient une référence à un groupe de sécurité d’application. La quatrième commande obtient la carte réseau nic1 associée à la configuration IP qui doit être mise à jour. Set-AzNetworkInterfaceIpConfig définit l’adresse IP privée de l’adresse IP principale ipconfig1 sur 10.0.0.11 et crée une association avec le groupe de sécurité d’application récupéré. Enfin, la dernière commande met à jour l’interface réseau pour s’assurer que les modifications ont été apportées avec succès.
3 : Dissocier une configuration IP avec un pool d’adresses back-end application gateway
$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null
$nic | Set-AzNetworkInterface
Set-AzNetworkInterfaceIpConfig définit le pool d’adresses back-end de la passerelle d’application de l’ipconfig1 de configuration IP sur null et dissocie avec l’interface réseau. Enfin, la dernière commande met à jour l’interface réseau pour s’assurer que les modifications ont été apportées avec succès.
Paramètres
-ApplicationGatewayBackendAddressPool
Spécifie une collection de références de pool d’adresses principales application gateway auxquelles appartient cette configuration IP de l’interface réseau.
Type: | PSApplicationGatewayBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationGatewayBackendAddressPoolId
Spécifie une collection de références de pool d’adresses principales application gateway auxquelles appartient cette configuration IP de l’interface réseau.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationSecurityGroup
Spécifie une collection de références de groupe de sécurité d’application auxquelles appartient cette configuration IP de l’interface réseau.
Type: | PSApplicationSecurityGroup[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationSecurityGroupId
Spécifie une collection de références de groupe de sécurité d’application auxquelles appartient cette configuration IP de l’interface réseau.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewayLoadBalancerId
Spécifie l’ID de la configuration ip frontale du fournisseur d’équilibreur de charge de passerelle.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerBackendAddressPool
Spécifie une collection de références de pool d’adresses principales de l’équilibreur de charge auxquelles appartient cette configuration IP de l’interface réseau.
Type: | PSBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerBackendAddressPoolId
Spécifie une collection de références de pool d’adresses principales de l’équilibreur de charge auxquelles appartient cette configuration IP de l’interface réseau.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerInboundNatRule
Spécifie une collection de références de règle NAT (Load Balancer inbound Network Address Translation) auxquelles appartient cette configuration IP de l’interface réseau.
Type: | PSInboundNatRule[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerInboundNatRuleId
Spécifie une collection de références de règle NAT entrante de l’équilibreur de charge auquel appartient cette configuration IP de l’interface réseau.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Spécifie le nom de la configuration IP réseau pour laquelle cette applet de commande définit.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NetworkInterface
Spécifie un objet NetworkInterface . Cette applet de commande ajoute une configuration IP d’interface réseau à l’objet spécifié par ce paramètre.
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
Spécifie l’adresse IP statique de la configuration IP de l’interface réseau.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateIpAddressVersion
Spécifie la version d’adresse IP d’une configuration IP d’interface réseau. Les valeurs valides pour ce paramètre sont :
- IPv4
- IPv6
Type: | String |
Accepted values: | IPv4, IPv6 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIpAddress
Spécifie un objet PublicIPAddress . Cette applet de commande crée une référence à une adresse IP publique à associer à cette configuration IP de l’interface réseau.
Type: | PSPublicIpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIpAddressId
Cette applet de commande crée une référence à une adresse IP publique à associer à cette configuration IP de l’interface réseau.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subnet
Spécifie un objet Subnet . Cette applet de commande crée une référence à un sous-réseau dans lequel cette configuration IP de l’interface réseau est créée.
Type: | PSSubnet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetId
Cette applet de commande crée une référence à un sous-réseau dans lequel cette configuration IP de l’interface réseau est créée.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
String[]
PSApplicationGatewayBackendAddressPool[]
Sorties
Notes
- Mots clés : azure, azurerm, arm, resource, management, manager, network, networking
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour