다음을 통해 공유

Set-AzureVMExtension

  • 참조
모듈:
Azure

가상 머신에 대한 리소스 확장을 설정합니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

Set-AzureVMExtension
   [-ExtensionName] <String>
   [-Publisher] <String>
   [-Version] <String>
   [[-ReferenceName] <String>]
   [[-PublicConfiguration] <String>]
   [[-PrivateConfiguration] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMExtension
   [-ExtensionName] <String>
   [-Publisher] <String>
   [-Version] <String>
   [[-ReferenceName] <String>]
   [[-PublicConfigPath] <String>]
   [[-PrivateConfigPath] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMExtension
   [-ReferenceName] <String>
   [[-PublicConfiguration] <String>]
   [[-PrivateConfiguration] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMExtension
   [-ReferenceName] <String>
   [[-PublicConfigPath] <String>]
   [[-PrivateConfigPath] <String>]
   [-Disable]
   [-Uninstall]
   [[-PublicConfigKey] <String>]
   [[-PrivateConfigKey] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Set-AzureVMExtension cmdlet은 가상 머신에 대한 리소스 확장을 설정합니다.

예제

예제 1: 리소스 확장이 적용된 가상 머신 만들기

PS C:\> $X = New-AzureVMConfig -Name $VM -InstanceSize Small -ImageName $IMG;$X = Add-AzureProvisioningConfig -VM $X -Password $PWD -AdminUsername $USR -Windows;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext1 -Publisher $Publisher -Version $VER -PublicConfiguration $P1 -PrivateConfiguration $P2;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext2 -Publisher $Publisher -Version $VER -PublicConfiguration $P3 -PrivateConfiguration $P4;New-AzureVM -Location $LOC -ServiceName $SVC -VM $X;

이 명령은 리소스 확장이 적용된 가상 머신을 만듭니다.

매개 변수

-Disable

이 cmdlet이 확장 상태를 사용하지 않도록 설정함을 나타냅니다.

Type:SwitchParameter
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionName

가상 머신의 확장 이름을 지정합니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ForceUpdate

구성이 업데이트되지 않은 경우 이 cmdlet이 확장에 구성을 다시 적용했음을 나타냅니다.

Type:SwitchParameter
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 문의
  • SilentlyContinue
  • Stop
  • 일시 중단
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

정보 변수를 지정합니다.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateConfigKey

프라이빗 구성 키를 지정합니다.

Type:String
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PrivateConfigPath

프라이빗 구성 경로를 지정합니다.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PrivateConfiguration

프라이빗 구성 텍스트를 지정합니다.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicConfigKey

공개 구성 키를 지정합니다.

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicConfigPath

공용 구성 경로를 지정합니다.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicConfiguration

공용 구성 텍스트를 지정합니다.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Publisher

확장의 게시자를 지정합니다.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReferenceName

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

확장을 참조하는 데 사용할 수 있는 사용자 정의 문자열입니다. 확장을 가상 머신에 처음으로 추가할 때 지정해야 합니다. 후속 업데이트의 경우 확장을 업데이트하는 동안 이전에 사용한 참조 이름을 지정해야 합니다. 확장에 할당된 ReferenceName은 Get-AzureVM cmdlet을 사용하여 반환됩니다.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Uninstall

이 cmdlet이 가상 머신에서 리소스 확장을 제거했음을 나타냅니다.

Type:SwitchParameter
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

확장 버전을 지정합니다.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VM

영구 가상 머신 개체를 지정합니다.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False