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
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

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

Typ:Int32
Position:2
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:infa
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliases:iv
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPName

Określa nazwę publicznego adresu IP.

Typ:String
Position:1
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

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

Typ:IPersistentVM
Aliases:InputObject
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wyjściowe

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM