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

Remove-WAPackVMRole

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

Удаляет объекты роли виртуальной машины.

Примечание.

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

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

Синтаксис

Remove-WAPackVMRole
      -VMRole <VMRole>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WAPackVMRole
      -VMRole <VMRole>
      -CloudServiceName <String>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

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

Командлет Remove-WAPackVMRole удаляет объекты роли виртуальной машины.

Примеры

Пример 1. Удаление роли виртуальной машины (созданной с помощью портала WAP)

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole01"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole

Первая команда получает роль виртуальной машины с именем ContosoVMRole01 с помощью командлета Get-WAPackVMRole , а затем сохраняет этот объект в переменной $VMRole.

Вторая команда удаляет роль виртуальной машины, хранящуюся в $VMRole. Командная строка запрашивает подтверждение. Если эта роль виртуальной машины была создана с помощью портала WAP, не нужно указывать имя облачной службы.

Пример 2. Удаление роли виртуальной машины, созданной после создания облачной службы вручную

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole02"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -CloudServiceName "ContosoCloudService02"

Первая команда получает роль виртуальной машины с именем ContosoVMRole02 с помощью командлета Get-WAPackVMRole , а затем сохраняет этот объект в переменной $VMRole.

Вторая команда удаляет роль виртуальной машины, хранящуюся в $VMRole. Командная строка запрашивает подтверждение. Если эта роль виртуальной машины не была создана с помощью портала, пользователю необходимо указать имя облачной службы. В этом случае с именем ContosoCloudService02.

Пример 3. Удаление роли виртуальной машины без подтверждения

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole03"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -Force

Первая команда получает облачную службу с именем ContosoVMRole03 с помощью командлета Get-WAPackVMRole , а затем сохраняет этот объект в переменной $VMRole.

Вторая команда удаляет роль виртуальной машины, хранящуюся в $VMRole. Эта команда включает параметр Force . Команда не запрашивает подтверждение.

Параметры

-CloudServiceName

Указывает имя облачной службы роли виртуальной машины.

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

-Confirm

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

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

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

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

-PassThru

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

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

-Profile

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

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

-VMRole

Указывает роль виртуальной машины. Чтобы получить роль виртуальной машины, используйте командлет Get-WAPackVMRole .

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

-WhatIf

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

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