다음을 통해 공유


Set-AzureRmVMExtension

확장 속성을 업데이트하거나 가상 머신에 확장을 추가합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Set-AzureRmVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-Settings <Hashtable>]
   [-ProtectedSettings <Hashtable>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-SettingString <String>]
   [-ProtectedSettingString <String>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzureRmVMExtension cmdlet은 기존 Virtual Machine 확장에 대한 속성을 업데이트하거나 가상 머신에 확장을 추가합니다.

예제

예제 1: 해시 테이블을 사용하여 설정 수정

PS C:\> $Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
PS C:\> $ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
PS C:\> Set-AzureRmVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -Type "CustomScriptExtension" -TypeHandlerVersion "1.1" -Settings $Settings -ProtectedSettings $ProtectedSettings;

처음 두 명령은 표준 Windows PowerShell 구문을 사용하여 해시 테이블을 만든 다음 해당 해시 테이블을 $Settings 및 $ProtectedSettings 변수에 저장합니다. 자세한 내용은 다음을 입력합니다 Get-Help about_Hash_Tables. 두 번째 명령에는 이전에 만들고 변수에 저장한 두 개의 값이 포함됩니다. 최종 명령은 $Settings 및 $ProtectedSettings 내용에 따라 ResourceGroup11에서 VirtualMachine22라는 가상 머신의 확장을 수정합니다. 이 명령은 게시자와 확장 유형을 포함하는 다른 필수 정보를 지정합니다.

예제 2: 문자열을 사용하여 설정 수정

PS C:\> $SettingsString = '{"fileUris":[],"commandToExecute":""}';
PS C:\> $ProtectedSettingsString = '{"storageAccountName":"' + $stoname + '","storageAccountKey":"' + $stokey + '"}';
PS C:\> Set-AzureRmVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "CustomScriptExtension" -Publisher "Contoso.Compute" -Type "CustomScriptExtension" -TypeHandlerVersion "1.1" -SettingString $SettingsString -ProtectedSettingString $ProtectedSettingsString ;

처음 두 명령은 설정을 포함하는 문자열을 만든 다음 $SettingsString 저장하고 변수를 $ProtectedSettingsString. 최종 명령은 $SettingsString 및 $ProtectedSettingsString 내용에 따라 ResourceGroup11에서 VirtualMachine22라는 가상 머신의 확장을 수정합니다. 이 명령은 게시자와 확장 유형을 포함하는 다른 필수 정보를 지정합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

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

-Confirm

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

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

-DefaultProfile

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

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

-DisableAutoUpgradeMinorVersion

이 cmdlet은 Azure 게스트 에이전트가 확장을 최신 부 버전으로 자동으로 업데이트하지 못하도록 합니다. 기본적으로 이 cmdlet을 사용하면 게스트 에이전트가 확장을 업데이트할 수 있습니다.

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

-ExtensionType

확장 유형을 지정합니다.

형식:String
별칭:Type
Position:Named
Default value:None
필수:True
파이프라인 입력 허용: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

확장의 이름을 지정합니다.

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

-ProtectedSettings

확장에 대한 프라이빗 구성을 해시 테이블로 지정합니다. 이 cmdlet은 프라이빗 구성을 암호화합니다.

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

-ProtectedSettingString

확장에 대한 프라이빗 구성을 문자열로 지정합니다. 이 cmdlet은 프라이빗 구성을 암호화합니다.

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

-Publisher

확장 게시자의 이름을 지정합니다. 게시자는 게시자가 확장을 등록할 때 이름을 제공합니다.

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

-ResourceGroupName

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

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

-Settings

확장에 대한 공용 구성을 해시 테이블로 지정합니다. 이 cmdlet은 공용 구성을 암호화하지 않습니다.

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

-SettingString

확장에 대한 공용 구성을 문자열로 지정합니다. 이 cmdlet은 공용 구성을 암호화하지 않습니다.

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

-TypeHandlerVersion

이 가상 머신에 사용할 확장 버전을 지정합니다.

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

-VMName

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

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

-WhatIf

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

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

입력

String

Hashtable

SwitchParameter

출력

PSAzureOperationResponse