Get-AzurePublishSettingsFile
Azure 구독에 대한 게시 설정 파일을 다운로드합니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
Get-AzurePublishSettingsFile
[-Environment <String>]
[-Realm <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Get-AzurePublishSettingsFile cmdlet은 계정의 구독에 대한 게시 설정 파일을 다운로드합니다. 명령이 완료되면 Import-PublishSettingsFile cmdlet을 사용하여 파일의 설정을 Windows PowerShell에서 사용할 수 있도록 할 수 있습니다.
Windows PowerShell에서 Azure 계정을 사용할 수 있도록 하려면 게시 설정 파일 또는 Add-AzureAccount cmdlet을 사용할 수 있습니다. 설정 파일을 게시하면 스크립트 및 백그라운드 작업을 무인으로 실행할 수 있도록 세션을 미리 준비할 수 있습니다. 그러나 모든 서비스가 게시 설정 파일을 지원하지는 않습니다. 예를 들어 AzureResourceManager 모듈은 게시 설정 파일을 지원하지 않습니다.
Get-AzurePublishSettingsFile을 실행하면 기본 브라우저가 열리고 Azure 계정에 로그인하고, 구독을 선택하고, 게시 설정 파일에 대한 파일 시스템 위치를 선택하라는 메시지가 표시됩니다. 그런 다음 구독에 대한 게시 설정 파일을 선택한 파일에 다운로드합니다.
"게시 설정 파일"은 .publishsettings 파일 이름 확장명을 가진 XML 파일입니다. 파일에는 Azure 구독에 대한 관리 자격 증명을 제공하는 인코딩된 인증서가 포함되어 있습니다.
보안 참고: 게시 설정 파일에는 Azure 구독 및 서비스를 관리하는 데 사용되는 자격 증명이 포함되어 있습니다. 악의적인 사용자가 게시 설정 파일에 액세스하는 경우 Azure 서비스를 편집, 만들기 및 삭제할 수 있습니다. 보안 모범 사례로 다운로드 또는 문서 폴더의 위치에 파일을 저장한 다음 Import-AzurePublishSettingsFile cmdlet을 사용하여 설정을 가져온 후 삭제합니다.
이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.10 버전에 있는 cmdlet에 대해 설명합니다.
사용 중인 모듈의 버전을 얻으려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.
예제
예제 1: 게시 설정 파일 다운로드
PS C:\> Get-AzurePublishSettingsFile이 명령은 기본 브라우저를 열고, Windows Azure 계정에 연결한 다음, 계정에 대한 .publishsettings 파일을 다운로드합니다.
예제 2: 영역 지정
PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru이 명령은 contoso.com 도메인의 계정에 대한 게시 설정 파일을 다운로드합니다. Microsoft 계정 대신 조직 계정으로 Azure에 로그인할 때 Realm 매개 변수와 함께 명령을 사용합니다.
매개 변수
-Environment
Azure 환경을 지정합니다.
Azure 환경은 글로벌 Azure용 AzureCloud 및 중국의 21Vianet에서 운영하는 Azure용 AzureChinaCloud와 같은 Microsoft Azure의 독립적인 배포입니다. Azure 팩 및 WAPack cmdlet을 사용하여 온-프레미스 Azure 환경을 만들 수도 있습니다. 자세한 내용은 Azure 팩을 참조 하세요.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PassThru
명령이 성공하면 $True 반환하고 실패하면 $False. 기본적으로 이 cmdlet은 출력을 반환하지 않습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
| 형식: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Realm
조직 ID로 조직을 지정합니다. 예를 들어 Azureadmin@contoso.com에 로그인하면 Realm 매개 변수의 값이 contoso.com. 조직 ID를 사용하여 Azure Portal에 로그인할 때 이 매개 변수를 사용합니다. outlook.com 또는 live.com 계정과 같은 Microsoft 계정을 사용하는 경우에는 이 매개 변수가 필요하지 않습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
입력
None
속성 이름으로 이 cmdlet에 입력을 파이프할 수 있지만 값으로는 파이프할 수 없습니다.
출력
None or System.Boolean
PassThru 매개 변수를 사용하는 경우 이 cmdlet은 부울 값을 반환합니다. 그렇지 않으면 이 cmdlet은 출력을 반환하지 않습니다.