Set-AzureVMDscExtension

참조

모듈:: Azure

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

참고

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

Syntax

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 파일)의 이름을 지정합니다. 이 매개 변수는 경로 없이 파일 이름만 지정해야 합니다.

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

-ConfigurationArgument

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

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

기본 형식
문자열
array
PSCredential

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

-ConfigurationDataPath

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

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

-ConfigurationName

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

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

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContainerName

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

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

-DataCollection

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

-Force

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

Type:	SwitchParameter
Position:	Named
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

-Profile

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

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

-ReferenceName

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

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

-StorageContext

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

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

-StorageEndpointSuffix

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

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

-Version

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

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WmfVersion

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

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

기본값은 최신입니다.

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

Share via

Set-AzureVMDscExtension

Syntax

Description

예제

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

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

매개 변수

-ConfigurationArchive

-ConfigurationArgument

-ConfigurationDataPath

-ConfigurationName

-Confirm

-ContainerName

-DataCollection

-Force

-InformationAction

-InformationVariable

-Profile

-ReferenceName

-StorageContext

-StorageEndpointSuffix

-Version

-VM

-WhatIf

-WmfVersion

추가 리소스

Share via

Set-AzureVMDscExtension

Syntax

Description

예제

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

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

매개 변수

-ConfigurationArchive

-ConfigurationArgument

-ConfigurationDataPath

-ConfigurationName

-Confirm

-ContainerName

-DataCollection

-Force

-InformationAction

-InformationVariable

-Profile

-ReferenceName

-StorageContext

-StorageEndpointSuffix

-Version

-VM

-WhatIf

-WmfVersion

관련 링크

추가 리소스