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

Set-AzureSubscription

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

Изменяет подписку Azure.

Примечание.

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

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью 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>]

Описание

Командлет Set-AzureSubscription устанавливает и изменяет свойства объекта подписки Azure. Этот командлет можно использовать для работы в подписке Azure, которая не является вашей подпиской по умолчанию или для изменения текущей учетной записи хранения. Сведения о текущих и стандартных подписках см. в командлете Select-AzureSubscription .

Этот командлет работает с объектом подписки Azure, а не вашей фактической подпиской Azure. Чтобы создать и подготовить подписку Azure, посетите портал Azure (https://azure.microsoft.com/).

Этот командлет изменяет данные в файле данных подписки, создаваемом при использовании командлета Add-AzureAccount или Import-AzurePublishSettingsFile для добавления учетной записи Azure в Windows PowerShell.

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

Эта команда задает значения свойств Certificate и 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 независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.

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

-PassThru

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

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

-Profile

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

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

-ResourceManagerEndpoint

Указывает конечную точку для данных Azure Resource Manager, включая данные о группах ресурсов, связанных с учетной записью. Дополнительные сведения о Azure Resource Manager см. в разделе "Командлеты Azure Resource Manager" (https://go.microsoft.com/fwlink/?LinkID=394765) и использование Windows PowerShell с Resource Manager (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

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

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

None or System.Boolean

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