Partager via

Set-AzurePublicIP

  • Référence
Module:
Azure

Ajoute une adresse IP publique à une machine virtuelle Azure.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Set-AzurePublicIP
   [-PublicIPName] <String>
   [[-IdleTimeoutInMinutes] <Int32>]
   [[-DomainNameLabel] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzurePublicIP ajoute une adresse IP publique à une machine virtuelle Azure. Si vous exécutez cette applet de commande pour une machine virtuelle existante, mettez à jour la machine virtuelle pour implémenter vos modifications. Vous pouvez spécifier une étiquette de nom de domaine pour créer une entrée DNS correspondante pour l’adresse IP publique.

Exemples

Exemple 1 : Ajouter une adresse IP publique à une machine virtuelle existante

PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" | Update-AzureVM

Cette commande obtient la machine virtuelle nommée FTPInstance dans le service nommé FTPInAzure à l’aide de l’applet de commande Get-AzureVM . La commande transmet cette machine virtuelle à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle ajoute le nom d’adresse IP publique ftpip. La commande transmet la machine virtuelle à l’applet de commande Update-AzureVM , qui implémente vos modifications.

Exemple 2 : Ajouter une adresse IP publique à une nouvelle machine virtuelle

PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"

Cette commande crée un objet de configuration de machine virtuelle à l’aide de l’applet de commande New-AzureVMConfig . La commande transmet cet objet à l’applet de commande Add-AzureProvisioningConfig , qui fournit une configuration supplémentaire. L’applet de commande actuelle ajoute le nom d’adresse IP publique ftpip. La commande transmet la configuration à l’applet de commande New-AzureVM , qui crée la machine virtuelle.

Exemple 3 : Ajouter une adresse IP publique et une étiquette à une machine virtuelle existante

PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | Update-AzureVM

Cette commande obtient la machine virtuelle nommée FTPInstance dans le service nommé FTPInAzure à l’aide de l’applet de commande Get-AzureVM . La commande transmet cette machine virtuelle à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle ajoute le nom d’adresse IP publique ftpip et le nom ipname d’étiquette. La commande met à jour la machine virtuelle, qui implémente vos modifications.

Exemple 4 : Ajouter une adresse IP publique et une étiquette à une nouvelle machine virtuelle

PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName $images[50].ImageName | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"

Cette commande crée un objet de configuration de machine virtuelle, puis passe cet objet à Add-AzureProvisioningConfig, qui fournit une configuration supplémentaire. L’applet de commande actuelle ajoute le nom d’adresse IP publique ftpip et le nom ipname d’étiquette. La commande crée la machine virtuelle.

Paramètres

-DomainNameLabel

Spécifie le nom à utiliser pour une entrée DNS correspondante pour l’adresse IP publique.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IdleTimeoutInMinutes

Spécifie le délai d’inactivité TCP en minutes.

Type:Int32
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Alias:iv
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicIPName

Spécifie le nom d’adresse IP publique.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VM

Spécifie la machine virtuelle à laquelle cette applet de commande ajoute une adresse IP publique.

Type:IPersistentVM
Alias:InputObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM