Set-AzureRmNetworkInterfaceIpConfig
Définit l’état d’objectif d’une configuration IP d’interface réseau Azure.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Set-AzureRmNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-Subnet <PSSubnet>]
[-PublicIpAddress <PSPublicIpAddress>]
[-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
[-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
[-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
[-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzureRmNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-SubnetId <String>]
[-PublicIpAddressId <String>]
[-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
[-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
[-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
[-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
L’applet de commande Set-AzureRmNetworkInterfaceIpConfig définit l’état d’objectif d’une configuration IP de l’interface réseau Azure.
Exemples
1 : Modification de l’adresse IP d’une configuration IP
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet
-Primary
$nic | Set-AzureRmNetworkInterfaceLes 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-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg
$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg
-Primary
$nic | Set-AzureRmNetworkInterfaceDans 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-AzureRmNetworkInterfaceIpConfig définit l’adresse IP privée de l’ipconfig1 de configuration IP principale 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.
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: | List<T>[PSApplicationGatewayBackendAddressPool] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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: | List<T>[String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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: | List<T>[PSApplicationSecurityGroup] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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: | List<T>[String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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: | List<T>[PSBackendAddressPool] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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: | List<T>[String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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: | List<T>[PSInboundNatRule] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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: | List<T>[String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom de la configuration IP réseau pour laquelle cette applet de commande définit.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Primary
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PrivateIpAddress
Spécifie l’adresse IP statique de la configuration IP de l’interface réseau.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeurs acceptées: | IPv4, IPv6 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Paramètres : NetworkInterface (ByValue)
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
Sorties
Notes
- Mots clés : azure, azurerm, arm, resource, management, manager, network, networking