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

Get-AzurePublishSettingsFile

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

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

Примечание.

Командлеты, приведенные в этой документации, предназначены для управления устаревшими ресурсами Azure, которые используют API-интерфейсами управления службами. Командлеты для управления ресурсами Azure Resource Manager см. в статье Модуль Az 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Realm

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

None

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

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

None or System.Boolean

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