Set-AzureVMDscExtension

참조

모듈:: Azure

가상 머신에서 DSC 확장을 구성합니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

Set-AzureVMDscExtension
   [-ReferenceName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationDataPath <String>]
   [-ConfigurationArchive] <String>
   [-ConfigurationName <String>]
   [-ContainerName <String>]
   [-Force]
   [-StorageContext <AzureStorageContext>]
   [-Version <String>]
   [-StorageEndpointSuffix <String>]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzureVMDscExtension cmdlet은 가상 머신에서 DSC(필요한 상태 구성) 확장을 구성합니다.

예제

예제 1: 가상 머신에서 DSC 확장 구성

PS C:\> Set-AzureVMDscExtension -VM $VM -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Path = 'C:\MyDirectory' }
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Contoso.Compute.BGInfo}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd6
OperationStatus             : OK

이 명령은 가상 머신에서 DSC 확장을 구성합니다.

MyConfiguration.ps1.zip 패키지는 이전에 Publish-AzureVMDscConfiguration 명령을 사용하여 Azure Storage에 업로드되어야 하며 MyConfiguration.ps1 스크립트와 이 패키지가 사용하는 모듈을 포함해야 합니다.

MyConfiguration 인수는 실행할 스크립트 내의 특정 DSC 구성을 나타냅니다. -ConfigurationArgument 매개 변수는 구성 함수에 전달되는 인수를 사용하여 해시 테이블을 지정합니다.

예제 2: 구성 데이터의 경로를 사용하여 가상 머신에서 DSC 확장 구성

PS C:\> $VM | Set-AzureVMDscExtension -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Credential = Get-Credential } -ConfigurationDataPath MyConfigurationData.psd1
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Microsoft.Compute.BGInfo, Microsoft.Powershell.DSC}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd7
OperationStatus             : OK

이 명령은 구성 데이터의 경로를 사용하여 가상 머신에서 DSC 확장을 구성합니다.

매개 변수

-ConfigurationArchive

Publish-AzureVMDscConfiguration에서 이전에 업로드한 구성 패키지(.zip 파일)의 이름을 지정합니다. 이 매개 변수는 경로 없이 파일 이름만 지정해야 합니다.

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

-ConfigurationArgument

구성 함수에 대한 인수를 지정하는 해시 테이블을 지정합니다. 키는 매개 변수 이름과 매개 변수 값 값에 해당합니다.

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

기본 형식
string
배열
PSCredential

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

-ConfigurationDataPath

구성 함수의 데이터를 지정하는 .psd1 파일의 경로를 지정합니다. 이 파일에는 구성 및 환경 데이터 구분에 설명된 대로 해시 테이블이 포함되어야 합니다.https://msdn.microsoft.com/en-us/PowerShell/DSC/configData.

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

-ConfigurationName

DSC 확장에서 호출하는 구성 스크립트 또는 모듈의 이름을 지정합니다.

이 매개 변수의 값은 ConfigurationArchive에 패키지된 스크립트 또는 모듈에 포함된 구성 함수 중 하나의 이름이어야 합니다.

이 cmdlet은 확장명을 제외한 이 매개 변수를 생략하는 경우 ConfigurationArchive 매개 변수에 의해 지정된 파일의 이름으로 기본 설정됩니다. 예를 들어 ConfigurationArchive가 "SalesWebSite.ps1.zip"인 경우 ConfigurationName의 기본값은 "SalesWebSite"입니다.

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

-Confirm

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

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

-ContainerName

ConfigurationArchive가 있는 Azure Storage 컨테이너의 이름을 지정합니다.

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

-DataCollection

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

-Force

이 cmdlet이 기존 Blob을 덮어씁니다.

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

-InformationAction

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

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

계속
무시
묻다
SilentlyContinue
중지
일시 중단됨

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

-InformationVariable

정보 변수를 지정합니다.

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

-Profile

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

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

-ReferenceName

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

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

-StorageContext

구성 스크립트에 액세스하는 데 사용되는 보안 설정을 제공하는 Azure Storage 컨텍스트를 지정합니다. 이 컨텍스트는 ContainerName 매개 변수로 지정된 컨테이너에 대한 읽기 액세스를 제공합니다.

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

-StorageEndpointSuffix

모든 스토리지 서비스(예: "core.contoso.net")에 대한 DNS 엔드포인트 접미사를 지정합니다.

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

-Version

사용할 DSC 확장의 특정 버전을 지정합니다. 이 매개 변수를 지정하지 않으면 기본값이 "1.*"로 설정됩니다.

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

-VM

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

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

-WhatIf

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

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

-WmfVersion

가상 머신에 설치할 WMF(Windows Management Framework)의 버전을 지정합니다. DSC 확장은 WMF 업데이트에서만 사용할 수 있는 DSC 기능에 따라 달라집니다. 이 매개 변수는 가상 머신에 설치할 업데이트 버전을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

4.0. 최신 버전이 이미 설치되어 있지 않으면 WMF 4.0을 설치합니다.
5.0. WMF 5.0의 최신 릴리스를 설치합니다.
최근. 최신 WMF( 현재 WMF 5.0)를 설치합니다.

기본값은 latest입니다.

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

다음을 통해 공유

Set-AzureVMDscExtension

구문

Description

예제

예제 1: 가상 머신에서 DSC 확장 구성

예제 2: 구성 데이터의 경로를 사용하여 가상 머신에서 DSC 확장 구성

매개 변수

-ConfigurationArchive

-ConfigurationArgument

-ConfigurationDataPath

-ConfigurationName

-Confirm

-ContainerName

-DataCollection

-Force

-InformationAction

-InformationVariable

-Profile

-ReferenceName

-StorageContext

-StorageEndpointSuffix

-Version

-VM

-WhatIf

-WmfVersion

추가 리소스

다음을 통해 공유

Set-AzureVMDscExtension

구문

Description

예제

예제 1: 가상 머신에서 DSC 확장 구성

예제 2: 구성 데이터의 경로를 사용하여 가상 머신에서 DSC 확장 구성

매개 변수

-ConfigurationArchive

-ConfigurationArgument

-ConfigurationDataPath

-ConfigurationName

-Confirm

-ContainerName

-DataCollection

-Force

-InformationAction

-InformationVariable

-Profile

-ReferenceName

-StorageContext

-StorageEndpointSuffix

-Version

-VM

-WhatIf

-WmfVersion

관련 링크

추가 리소스