Udostępnij za pośrednictwem

Set-AzurePublicIP

  • Odwołanie
Moduł:
Azure

Dodaje publiczny adres IP do maszyny wirtualnej platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Set-AzurePublicIP dodaje publiczny adres IP do maszyny wirtualnej platformy Azure. Jeśli uruchomisz to polecenie cmdlet dla istniejącej maszyny wirtualnej, zaktualizuj maszynę wirtualną, aby zaimplementować zmiany. Możesz określić etykietę nazwy domeny, aby utworzyć odpowiedni wpis DNS dla publicznego adresu IP.

Przykłady

Przykład 1. Dodawanie publicznego adresu IP do istniejącej maszyny wirtualnej

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

To polecenie pobiera maszynę wirtualną o nazwie FTPInstance w usłudze o nazwie FTPInAzure przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje maszynę wirtualną do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet dodaje nazwę publicznego adresu IP ftpip. Polecenie przekazuje maszynę wirtualną do polecenia cmdlet Update-AzureVM , które implementuje zmiany.

Przykład 2. Dodawanie publicznego adresu IP do nowej maszyny wirtualnej

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"

To polecenie tworzy obiekt konfiguracji maszyny wirtualnej przy użyciu polecenia cmdlet New-AzureVMConfig . Polecenie przekazuje ten obiekt do polecenia cmdlet Add-AzureProvisioningConfig , które zapewnia dodatkową konfigurację. Bieżące polecenie cmdlet dodaje nazwę publicznego adresu IP ftpip. Polecenie przekazuje konfigurację do polecenia cmdlet New-AzureVM , które tworzy maszynę wirtualną.

Przykład 3. Dodawanie publicznego adresu IP i etykiety do istniejącej maszyny wirtualnej

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

To polecenie pobiera maszynę wirtualną o nazwie FTPInstance w usłudze o nazwie FTPInAzure przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje maszynę wirtualną do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet dodaje nazwę publicznego adresu IP ftpip i etykietę ipname. Polecenie aktualizuje maszynę wirtualną, która implementuje zmiany.

Przykład 4. Dodawanie publicznego adresu IP i etykiety do nowej maszyny wirtualnej

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"

To polecenie tworzy obiekt konfiguracji maszyny wirtualnej, a następnie przekazuje ten obiekt do polecenia Add-AzureProvisioningConfig, który zapewnia dodatkową konfigurację. Bieżące polecenie cmdlet dodaje nazwę publicznego adresu IP ftpip i etykietę ipname. Polecenie tworzy maszynę wirtualną.

Parametry

-DomainNameLabel

Określa nazwę używaną dla odpowiedniego wpisu DNS dla publicznego adresu IP.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdleTimeoutInMinutes

Określa limit czasu bezczynności protokołu TCP w minutach.

Typ:Int32
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliasy:iv
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIPName

Określa nazwę publicznego adresu IP.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VM

Określa maszynę wirtualną, do której to polecenie cmdlet dodaje publiczny adres IP.

Typ:IPersistentVM
Aliasy:InputObject
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM