다음을 통해 공유


Set-AzurePublicIP

Azure 가상 머신에 공용 IP를 추가합니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

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

Description

Set-AzurePublicIP cmdlet은 Azure 가상 머신에 공용 IP를 추가합니다. 기존 가상 머신에 대해 이 cmdlet을 실행하는 경우 변경 내용을 구현하도록 가상 머신을 업데이트합니다. 도메인 이름 레이블을 지정하여 공용 IP에 해당하는 DNS 항목을 만들 수 있습니다.

예제

예제 1: 기존 가상 머신에 공용 IP 추가

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

이 명령은 Get-AzureVM cmdlet을 사용하여 FTPInAzure라는 서비스에서 FTPInstance라는 가상 머신을 가져옵니다. 이 명령은 파이프라인 연산자를 사용하여 해당 가상 머신을 현재 cmdlet에 전달합니다. 현재 cmdlet은 공용 IP 이름 ftpip를 추가합니다. 이 명령은 변경 내용을 구현하는 Update-AzureVM cmdlet에 가상 머신을 전달합니다.

예제 2: 새 가상 머신에 공용 IP 추가

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"

이 명령은 New-AzureVMConfig cmdlet을 사용하여 가상 머신 구성 개체를 만듭니다. 이 명령은 추가 구성을 제공하는 Add-AzureProvisioningConfig cmdlet에 해당 개체를 전달합니다. 현재 cmdlet은 공용 IP 이름 ftpip를 추가합니다. 이 명령은 가상 머신을 만드는 New-AzureVM cmdlet에 구성을 전달합니다.

예제 3: 기존 가상 머신에 공용 IP 및 레이블 추가

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

이 명령은 Get-AzureVM cmdlet을 사용하여 FTPInAzure라는 서비스에서 FTPInstance라는 가상 머신을 가져옵니다. 이 명령은 파이프라인 연산자를 사용하여 해당 가상 머신을 현재 cmdlet에 전달합니다. 현재 cmdlet은 공용 IP 이름 ftpip 및 레이블 ipname을 추가합니다. 이 명령은 변경 내용을 구현하는 가상 머신을 업데이트합니다.

예제 4: 새 가상 머신에 공용 IP 및 레이블 추가

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"

이 명령은 가상 머신 구성 개체를 만든 다음 추가 구성을 제공하는 Add-AzureProvisioningConfig에 해당 개체를 전달합니다. 현재 cmdlet은 공용 IP 이름 ftpip 및 레이블 ipname을 추가합니다. 이 명령은 가상 머신을 만듭니다.

매개 변수

-DomainNameLabel

공용 IP 주소에 해당하는 DNS 항목에 사용할 이름을 지정합니다.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

TCP 유휴 제한 시간(분)을 지정합니다.

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 문의
  • SilentlyContinue
  • Stop
  • 일시 중단
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

정보 변수를 지정합니다.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPName

공용 IP 이름을 지정합니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

이 cmdlet이 공용 IP를 추가할 가상 머신을 지정합니다.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

출력

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM