Delen via


Set-AzurePublicIP

Hiermee voegt u een openbaar IP-adres toe aan een virtuele Azure-machine.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

De cmdlet Set-AzurePublicIP voegt een openbaar IP-adres toe aan een virtuele Azure-machine. Als u deze cmdlet uitvoert voor een bestaande virtuele machine, werkt u de virtuele machine bij om uw wijzigingen te implementeren. U kunt een domeinnaamlabel opgeven om een bijbehorende DNS-vermelding voor het openbare IP-adres te maken.

Voorbeelden

Voorbeeld 1: Een openbaar IP-adres toevoegen aan een bestaande virtuele machine

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

Met deze opdracht wordt de virtuele machine met de naam FTPInstance opgehaald in de service met de naam FTPInAzure met behulp van de Get-AzureVM-cmdlet . De opdracht geeft die virtuele machine door aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige cmdlet wordt ftpip van de openbare IP-naam toegevoegd. Met de opdracht wordt de virtuele machine doorgegeven aan de cmdlet Update-AzureVM , waarmee uw wijzigingen worden geïmplementeerd.

Voorbeeld 2: Een openbaar IP-adres toevoegen aan een nieuwe virtuele machine

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"

Met deze opdracht maakt u een configuratieobject voor virtuele machines met behulp van de cmdlet New-AzureVMConfig . De opdracht geeft dat object door aan de cmdlet Add-AzureProvisioningConfig , die aanvullende configuratie biedt. Met de huidige cmdlet wordt ftpip van de openbare IP-naam toegevoegd. Met de opdracht wordt de configuratie doorgegeven aan de cmdlet New-AzureVM , waarmee de virtuele machine wordt gemaakt.

Voorbeeld 3: Een openbaar IP-adres en label toevoegen aan een bestaande virtuele machine

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

Met deze opdracht wordt de virtuele machine met de naam FTPInstance opgehaald in de service met de naam FTPInAzure met behulp van de Get-AzureVM-cmdlet . De opdracht geeft die virtuele machine door aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige cmdlet worden ftpip en de ip-naam van het label toegevoegd. Met de opdracht wordt de virtuele machine bijgewerkt, waarmee uw wijzigingen worden geïmplementeerd.

Voorbeeld 4: Een openbaar IP-adres en label toevoegen aan een nieuwe virtuele machine

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"

Met deze opdracht maakt u een configuratieobject voor virtuele machines en geeft u dat object vervolgens door aan Add-AzureProvisioningConfig, dat aanvullende configuratie biedt. Met de huidige cmdlet worden ftpip en de ip-naam van het label toegevoegd. Met de opdracht wordt de virtuele machine gemaakt.

Parameters

-DomainNameLabel

Hiermee geeft u de naam op die moet worden gebruikt voor een overeenkomende DNS-vermelding voor het openbare IP-adres.

Type:String
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdleTimeoutInMinutes

Hiermee geeft u de time-outperiode voor TCP inactief in minuten op.

Type:Int32
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicIPName

Hiermee geeft u de openbare IP-naam.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VM

Hiermee geeft u de virtuele machine waarop deze cmdlet openbaar IP-adres toevoegt.

Type:IPersistentVM
Aliassen:InputObject
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM