다음을 통해 공유

Set-AzVMAccessExtension

모듈:
Az.Compute Module

VMAccess 확장을 가상 머신에 추가합니다.

구문

Default (기본값) 

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 확장을 가상 머신에 추가합니다. (autogenerated)

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

매개 변수

-Confirm

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Credential

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

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-DefaultProfile

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

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DisableAutoUpgradeMinorVersion

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ForceRerun

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Location

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:ExtensionName

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-NoWait

작업을 시작하고 작업이 완료되기 전에 즉시 반환합니다. 작업이 성공적으로 완료되었는지 확인하려면 다른 메커니즘을 사용합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceGroupName

가상 머신의 리소스 그룹의 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-TypeHandlerVersion

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:HandlerVersion, 버전

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-VMName

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:자원명

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSCredential

String

SwitchParameter

출력

PSAzureOperationResponse