Set-AzNetworkInterfaceIpConfig
Met à jour une configuration IP pour une interface réseau.
Syntaxe
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
Exemple 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.
Exemple 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.
Exemple 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 |
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: | 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: | 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: | 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: | AzContext, 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 |
-GatewayLoadBalancerId
Spécifie l’ID de la configuration ip frontale du fournisseur d’équilibreur de charge de passerelle.
Type: | 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 |
-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 |
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: | 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: | 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: | 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
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