Set-AzVMAccessExtension

Модуль:

Az.Compute

Добавляет расширение VMAccess в виртуальную машину.

Синтаксис

Set-AzVMAccessExtension
   [-Credential <PSCredential>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-AzVMAccessExtension добавляет расширение VMAccess виртуальной машины для виртуальной машины (VMAccess) виртуальной машины в виртуальную машину. Расширение VMAccess можно использовать для задания временного пароля, и его следует немедленно изменить после входа на компьютер. Это не поддерживается в контроллерах домена Windows.

Примеры

Пример 1. Добавление расширения VMAccess

Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"

Эта команда добавляет расширение VMAccess для виртуальной машины с именем VirtualMachine07 в ResourceGroup11. Команда задает версию обработчика имен и типов для VMAccess.

Пример 2

Добавляет расширение VMAccess в виртуальную машину. (автоматическое создание)

Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'

Параметры

-Confirm

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

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

-Credential

Указывает имя пользователя и пароль виртуальной машины в качестве объекта PSCredential . Если вы укажете не текущую учетную запись локального администратора виртуальной машины, а другое имя, то расширение VMAccess добавит учетную запись локального администратора с этим именем и назначит ей указанный пароль. Если учетная запись локального администратора на виртуальной машине существует, расширение VMAccess сбросит пароль, а если эта учетная запись отключена, расширение VMAccess включит ее. Чтобы получить учетные данные, используйте командлет Get-Credential. Для получения дополнительных сведений введите Get-Help Get-Credential.

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

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

-DisableAutoUpgradeMinorVersion

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

-ForceRerun

Указывает, что этот командлет принудительно выполняет повторное выполнение той же конфигурации расширения на виртуальной машине без удаления и переустановки расширения. Значение может быть любой строкой, отличной от текущего значения. Если forceUpdateTag не изменяется, обновления общедоступных или защищенных параметров по-прежнему применяются обработчиком.

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

-Location

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

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

-Name

Указывает имя расширения, которое добавляет этот командлет.

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

-NoWait

Запускает операцию и возвращается немедленно перед завершением операции. Чтобы определить, успешно ли выполнена операция, используйте другой механизм.

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

-ResourceGroupName

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

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

-TypeHandlerVersion

Указывает версию расширения, используемого для этой виртуальной машины. Чтобы получить версию, запустите командлет Get-AzVMExtensionImage со значением параметра Microsoft.Compute для параметра PublisherName и VMAccessAgent для параметра Type . У typeHandlerVersion должна быть версия 2.0 или новее, так как версия 1 больше не поддерживается.

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

-VMName

Указывает имя виртуальной машины. Этот командлет добавляет VMAccess для виртуальной машины, указанной этим параметром.

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

-WhatIf

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

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

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

PSCredential

String

SwitchParameter

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

PSAzureOperationResponse

Связанные ссылки

• Get-AzVMAccessExtension
• Remove-AzVMAccessExtension
• Set-AzVMExtension
• Get-AzVMExtensionImage