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>]

Description

Set-AzVMAccessExtension cmdlet은 가상 머신에 VMAccess(Virtual Machine Access) Virtual Machine VMAccess 확장을 추가합니다. VMAccess 확장을 사용하여 임시 암호를 설정할 수 있으며 머신에 로그인한 후 즉시 변경해야 합니다. Windows 도메인 컨트롤러에서는 지원되지 않습니다.

예제

예제 1: VMAccess 확장 추가

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

이 명령은 ResourceGroup11에서 VirtualMachine07이라는 가상 머신에 대한 VMAccess 확장을 추가합니다. 이 명령은 VMAccess의 이름 및 형식 처리기 버전을 지정합니다.

예제 2

VMAccess 확장을 가상 머신에 추가합니다. (자동 생성됨)

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

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Credential

가상 머신의 사용자 이름과 암호를 PSCredential 개체로 지정합니다. VM에서 현재 로컬 관리자 계정이 아닌 다른 이름을 입력한 경우 VMAccess 확장은 해당 이름으로 로컬 관리자 계정을 추가하고 해당 계정에 지정된 암호를 할당합니다. VM의 로컬 관리자 계정이 있는 경우 암호를 다시 설정하고 계정을 사용하지 않도록 설정하면 VMAccess 확장을 사용하도록 설정합니다. 자격 증명을 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 다음을 입력합니다 Get-Help Get-Credential.

형식:	PSCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableAutoUpgradeMinorVersion

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ForceRerun

이 cmdlet은 확장을 제거하고 다시 설치하지 않고 가상 머신에서 동일한 확장 구성을 강제로 다시 실행한다는 것을 나타냅니다. 값은 현재 값과 다른 문자열일 수 있습니다. forceUpdateTag가 변경되지 않은 경우 공용 또는 보호된 설정에 대한 업데이트는 처리기에서 계속 적용됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Location

가상 머신의 위치를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Name

이 cmdlet이 추가하는 확장의 이름을 지정합니다.

형식:	String
별칭:	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

이 가상 머신에 사용할 확장 버전을 지정합니다. 버전을 가져오려면 PublisherName 매개 변수에 대한 Microsoft.Compute 값과 Type 매개 변수에 대한 VMAccessAgent 값을 사용하여 Get-AzVMExtensionImage cmdlet을 실행합니다. typeHandlerVersion은 버전 1이 더 이상 사용되지 않으므로 2.0 이상이어야 합니다.

형식:	String
별칭:	HandlerVersion, Version
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-VMName

가상 머신의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 가상 머신에 대한 VMAccess를 추가합니다.

형식:	String
별칭:	ResourceName
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

PSCredential

String

SwitchParameter

출력

PSAzureOperationResponse

관련 링크

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