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

Remove-AzureSubscription

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

Удаляет подписку Azure из Windows PowerShell.

Примечание.

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

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

Синтаксис

Remove-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-AzureSubscription удаляет подписку Azure из файла данных подписки, чтобы Windows PowerShell не смог найти ее. Этот командлет не удаляет подписку из Microsoft Azure или не изменяет фактическую подписку каким-либо образом.

В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell. Чтобы получить версию используемого модуля, в консоли Azure PowerShell введите (Get-Module -Name Azure).Version.

Примеры

Пример 1. Удаление подписки

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Эта команда удаляет подписку Test из файла данных подписки по умолчанию.

Пример 2. Удаление из альтернативного файла данных подписки

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

Эта команда удаляет тестовую подписку из файла данных MySubscriptions.xml подписки. Команда использует параметр Force для подавления запроса подтверждения.

Пример 3. Удаление подписки в скрипте

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

Эта команда использует команду Remove-AzureSubscription в инструкции If . Он использует параметр PassThru , возвращающий логическое значение, чтобы определить, выполняется ли блок скрипта в инструкции If .

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Force

Подавляет запрос подтверждения.

Тип:SwitchParameter
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

-SubscriptionId

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

-SubscriptionName

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

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

None

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

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

None or System.Boolean

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