Set-AzureSubscription
Azure 구독을 변경합니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
Set-AzureSubscription
-SubscriptionId <String>
[-Certificate <X509Certificate2>]
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Set-AzureSubscription
-SubscriptionName <String>
[-Certificate <X509Certificate2>]
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Set-AzureSubscription
-SubscriptionName <String>
-SubscriptionId <String>
-Certificate <X509Certificate2>
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Set-AzureSubscription cmdlet은 Azure 구독 개체의 속성을 설정하고 변경합니다. 이 cmdlet을 사용하여 기본 구독이 아닌 Azure 구독에서 작업하거나 현재 스토리지 계정을 변경할 수 있습니다. 현재 및 기본 구독에 대한 자세한 내용은 Select-AzureSubscription cmdlet을 참조하세요.
이 cmdlet은 실제 Azure 구독이 아닌 Azure 구독 개체에서 작동합니다. Azure 구독을 만들고 프로비전하려면 Azure Portal(https://azure.microsoft.com/)을 방문하세요.
이 cmdlet은 Add-AzureAccount 또는 Import-AzurePublishSettingsFile cmdlet을 사용하여 Windows PowerShell에 Azure 계정을 추가할 때 만드는 구독 데이터 파일의 데이터를 변경합니다.
이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.10 버전에 있는 cmdlet에 대해 설명합니다.
사용 중인 모듈의 버전을 얻으려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.
예제
예제 1: 기존 구독 변경1
C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert다음은 ContosoEngineering이라는 구독에 대한 인증서를 변경하는 예제입니다.
예제 2: 서비스 엔드포인트 변경
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"이 명령은 ContosoEngineering 구독에 대한 사용자 지정 서비스 엔드포인트를 추가하거나 변경합니다.
예제 3: 속성 값 지우기
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null이 명령은 인증서 및 ResourceManagerEndpoint 속성의 값을 null($Null)로 설정합니다. 이렇게 하면 다른 설정을 변경하지 않고 해당 속성의 값이 지워집니다.
예제 4: 대체 구독 데이터 파일 사용
C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01이 명령은 ContosoFinance 구독의 현재 스토리지 계정을 ContosoStorage01로 변경합니다. 이 명령은 SubscriptionDataFile 매개 변수를 사용하여 C:\Azure\SubscriptionData.xml 구독 데이터 파일의 데이터를 변경합니다. 기본적으로 Set-AzureSubscription 은 로밍 사용자 프로필의 기본 구독 데이터 파일을 사용합니다.
매개 변수
-Certificate
| 형식: | X509Certificate2 |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Context
| 형식: | AzureStorageContext |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-CurrentStorageAccountName
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Environment
Azure 환경을 지정합니다.
Azure 환경은 글로벌 Azure용 AzureCloud 및 중국의 21Vianet에서 운영하는 Azure용 AzureChinaCloud와 같은 Microsoft Azure의 독립적인 배포입니다. Azure 팩 및 WAPack cmdlet을 사용하여 온-프레미스 Azure 환경을 만들 수도 있습니다. 자세한 내용은 Azure 팩을 참조 하세요.
| 형식: | String |
| 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 |
-ResourceManagerEndpoint
계정과 연결된 리소스 그룹에 대한 데이터를 포함하여 Azure Resource Manager 데이터의 엔드포인트를 지정합니다. Azure Resource Manager에 대한 자세한 내용은 Azure Resource Manager Cmdlet() 및 Resource Manager와 https://go.microsoft.com/fwlink/?LinkID=394765함께 Windows PowerShell 사용(https://go.microsoft.com/fwlink/?LinkID=394767)을 참조하세요.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ServiceEndpoint
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SubscriptionId
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SubscriptionName
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
입력
None
속성 이름으로 이 cmdlet에 입력을 파이프할 수 있지만 값으로는 파이프할 수 없습니다.
출력
None or System.Boolean
PassThru 매개 변수를 사용하는 경우 이 cmdlet은 부울 값을 반환합니다. 기본적으로 이 cmdlet은 출력을 반환하지 않습니다.