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 |