다음을 통해 공유

Remove-WAPackVMRole

  • 참조
모듈:
Azure

가상 머신 역할 개체를 제거합니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

Remove-WAPackVMRole
      -VMRole <VMRole>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WAPackVMRole
      -VMRole <VMRole>
      -CloudServiceName <String>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

이러한 항목은 더 이상 사용되지 않으며 나중에 제거될 예정입니다. 이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.1 버전에 있는 cmdlet에 대해 설명합니다. 사용 중인 모듈의 버전을 확인하려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.

Remove-WAPackVMRole cmdlet은 가상 머신 역할 개체를 제거합니다.

예제

예제 1: WAP 포털을 사용하여 만든 가상 머신 역할 제거

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole01"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole

첫 번째 명령은 Get-WAPackVMRole cmdlet을 사용하여 ContosoVMRole01이라는 가상 머신 역할을 가져온 다음 해당 개체를 $VMRole 변수에 저장합니다.

두 번째 명령은 $VMRole 저장된 가상 머신 역할을 제거합니다. 이 명령은 확인 메시지를 표시합니다. WAP 포털을 사용하여 이 가상 머신 역할을 만들었다고 가정할 때 클라우드 서비스 이름을 지정할 필요가 없습니다.

예제 2: 클라우드 서비스를 수동으로 만든 후 만들어진 가상 머신 역할 제거

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole02"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -CloudServiceName "ContosoCloudService02"

첫 번째 명령은 Get-WAPackVMRole cmdlet을 사용하여 "ContosoVMRole02"라는 가상 머신 역할을 가져온 다음 해당 개체를 $VMRole 변수에 저장합니다.

두 번째 명령은 $VMRole 저장된 가상 머신 역할을 제거합니다. 이 명령은 확인 메시지를 표시합니다. 이 가상 머신 역할이 포털을 사용하여 만들어지지 않았다고 가정하면 사용자는 클라우드 서비스 이름을 지정해야 합니다. 이 경우 이름이 "ContosoCloudService02"입니다.

예제 3: 확인 없이 가상 머신 역할 제거

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole03"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -Force

첫 번째 명령은 Get-WAPackVMRole cmdlet을 사용하여 ContosoVMRole03이라는 클라우드 서비스를 가져오고 해당 개체를 $VMRole 변수에 저장합니다.

두 번째 명령은 $VMRole 저장된 가상 머신 역할을 제거합니다. 이 명령에는 Force 매개 변수가 포함됩니다. 이 명령은 확인 메시지를 표시하지 않습니다.

매개 변수

-CloudServiceName

가상 머신 역할의 클라우드 서비스 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Profile

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

형식:AzureSMProfile
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VMRole

가상 머신 역할을 지정합니다. 가상 머신 역할을 얻으려면 Get-WAPackVMRole cmdlet을 사용합니다.

형식:VMRole
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False