다음을 통해 공유

Remove-AzureSubscription

  • 참조
모듈:
Azure

Windows PowerShell에서 Azure 구독을 삭제합니다.

참고 항목

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

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

구문

Remove-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-AzureSubscription cmdlet은 구독 데이터 파일에서 Azure 구독을 삭제하므로 Windows PowerShell에서 찾을 수 없습니다. 이 cmdlet은 Microsoft Azure에서 구독을 삭제하거나 실제 구독을 어떤 방식으로든 변경하지 않습니다.

이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.10 버전에 있는 cmdlet에 대해 설명합니다. 사용 중인 모듈의 버전을 얻으려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.

예제

예제 1: 구독 삭제

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

이 명령은 기본 구독 데이터 파일에서 "테스트" 구독을 삭제합니다.

예제 2: 대체 구독 데이터 파일에서 삭제

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

이 명령은 MySubscriptions.xml 구독 데이터 파일에서 테스트 구독을 삭제합니다. 이 명령은 Force 매개 변수를 사용하여 확인 프롬프트를 표시하지 않습니다.

예제 3: 스크립트에서 구독 삭제

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

이 명령은 If 문의 Remove-AzureSubscription 명령을 사용합니다. 이 메서드는 부울 값을 반환하는 PassThru 매개 변수를 사용하여 If 문의 스크립트 블록이 실행되는지 여부를 확인합니다.

매개 변수

-Confirm

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

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

-Force

확인 프롬프트를 표시하지 않습니다.

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

-PassThru

명령이 성공하면 $True 반환하고 실패하면 $False. 기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

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

-Profile

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

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

-SubscriptionId

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

-SubscriptionName

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

-WhatIf

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

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

입력

None

속성 이름으로 이 cmdlet에 입력을 파이프할 수 있지만 값으로는 파이프할 수 없습니다.

출력

None or System.Boolean

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 부울 값을 반환합니다. 그렇지 않으면 출력을 반환하지 않습니다.