Поделиться через

Get-AzurePublishSettingsFile

  • Ссылка
Модуль:
Azure

Загружает файл параметров публикации для подписки Azure.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

Get-AzurePublishSettingsFile
   [-Environment <String>]
   [-Realm <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Описание

Командлет Get-AzurePublishSettingsFile скачивает файл параметров публикации для подписки в вашей учетной записи. По завершении команды можно использовать командлет Import-PublishSettingsFile , чтобы сделать параметры в файле доступными для Windows PowerShell.

Чтобы сделать учетную запись Azure доступной в Windows PowerShell, можно использовать файл параметров публикации или командлет Add-AzureAccount . Файлы параметров публикации позволяют заранее подготовить сеанс, чтобы можно было запускать скрипты и фоновые задания автоматически. Однако не все службы поддерживают файлы параметров публикации. Например, модуль AzureResourceManager не поддерживает файлы параметров публикации.

При запуске Get-AzurePublishSettingsFile он открывает браузер по умолчанию и предлагает войти в учетную запись Azure, выбрать подписку и выбрать расположение файловой системы для файла параметров публикации. Затем он скачивает файл параметров публикации для подписки в выбранный файл.

Файл параметров публикации — это XML-файл с расширением имени файла publishsettings. Файл содержит закодированный сертификат, предоставляющий учетные данные управления для подписок Azure.

Примечание по безопасности. Файлы параметров публикации содержат учетные данные, используемые для администрирования подписок и служб Azure. Если злоумышленники получают доступ к файлу параметров публикации, они могут изменять, создавать и удалять службы Azure. Рекомендуется сохранить файл в папке "Загрузки" или "Документы", а затем удалить его после использования командлета Import-AzurePublishSettingsFile для импорта параметров.

В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell. Чтобы получить версию используемого модуля, в консоли 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. Используйте команду с параметром Realm при входе в Azure с учетной записью организации, а не учетной записью Майкрософт.

Параметры

-Environment

Указывает среду Azure.

Среда Azure независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PassThru

Возвращает $True, если команда завершается успешно и $False, если она завершается ошибкой. По умолчанию этот командлет не возвращает выходные данные.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Realm

Указывает организацию в идентификаторе организации. Например, если войти в Azure как [email protected], значение параметра Realm contoso.com. Используйте этот параметр при использовании идентификатора организации для входа в портал Azure. Этот параметр не требуется при использовании учетной записи Майкрософт, например учетной записи outlook.com или учетной записи live.com.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

None

Входные данные можно передать в этот командлет по имени свойства, но не по значению.

Выходные данные

None or System.Boolean

При использовании параметра PassThru этот командлет возвращает логическое значение. В противном случае этот командлет не возвращает выходные данные