Set-AzVMDscExtension

  • 참조
모듈:
Az.Compute

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

Syntax

Set-AzVMDscExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-ArchiveBlobName] <String>
   [-ArchiveStorageAccountName] <String>
   [-ArchiveResourceGroupName <String>]
   [-ArchiveStorageEndpointSuffix <String>]
   [-ArchiveContainerName <String>]
   [-ConfigurationName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationData <String>]
   [-Version] <String>
   [-Force]
   [-Location <String>]
   [-AutoUpdate]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzVMDscExtension cmdlet은 리소스 그룹의 가상 머신에서 Windows PowerShell DSC(필요한 상태 구성) 확장을 구성합니다.

예제

예제 1: DSC 확장 설정

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

이 명령은 VM07이라는 가상 머신에서 DSC 확장을 설정하여 Stg라는 스토리지 계정과 기본 컨테이너에서 Sample.ps1.zip 다운로드합니다. 이 명령은 ConfigName이라는 구성을 호출합니다. Sample.ps1.zip 파일은 이전에 Publish-AzVMDscConfiguration을 사용하여 업로드되었습니다.

예제 2: 구성 데이터를 사용하여 DSC 확장 설정

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"

이 명령은 VM13이라는 가상 머신의 확장을 설정하여 Stg라는 스토리지 계정과 WindowsPowerShellDSC라는 컨테이너에서 Sample.ps1.zip 다운로드합니다. ConfigName이라는 구성을 지정하고 구성 데이터 및 인수를 지정하는 명령입니다. Sample.ps1.zip 파일은 이전에 Publish-AzVMDscConfiguration을 사용하여 업로드되었습니다.

예제 3: 자동 업데이트가 있는 구성 데이터를 사용하여 DSC 확장 설정

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate

이 명령은 VM22라는 가상 머신의 확장을 설정하여 Stg라는 스토리지 계정과 WindowsPowerShellDSC라는 컨테이너에서 Sample.ps1.zip 다운로드합니다. 이 명령은 ConfigName이라는 구성을 호출하고 구성 데이터 및 인수를 지정합니다. 또한 이 명령을 사용하면 확장 처리기를 최신 버전으로 자동 업데이트할 수 있습니다. Sample.ps1.zip 이전에 Publish-AzVMDscConfiguration을 사용하여 업로드되었습니다.

매개 변수

-ArchiveBlobName

Publish-AzVMDscConfiguration cmdlet에서 이전에 업로드한 구성 파일의 이름을 지정합니다.

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

-ArchiveContainerName

구성 보관이 있는 Azure Storage 컨테이너의 종 이름입니다.

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

-ArchiveResourceGroupName

구성 보관이 포함된 스토리지 계정을 포함하는 리소스 그룹의 이름을 지정합니다. 스토리지 계정과 가상 머신이 모두 동일한 리소스 그룹에 있는 경우 이 매개 변수는 선택 사항입니다.

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

-ArchiveStorageAccountName

ArchiveBlobName을 다운로드하는 데 사용되는 Azure Storage 계정 이름을 지정합니다.

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

-ArchiveStorageEndpointSuffix

스토리지 엔드포인트 접미사를 지정합니다.

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

-AutoUpdate

Version 매개 변수로 지정된 확장 처리기 버전을 지정합니다. 기본적으로 확장 처리기는 자동 업데이트되지 않습니다. AutoUpdate 매개 변수를 사용하여 확장 처리기를 사용 가능한 경우 최신 버전으로 자동 업데이트할 수 있습니다.

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

-ConfigurationArgument

구성 함수에 대한 인수를 포함하는 해시 테이블을 지정합니다.

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

-ConfigurationData

구성에 대한 데이터를 지정하는 .psd1 파일의 경로를 지정합니다.

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

-ConfigurationName

DSC 확장이 호출하는 구성의 이름을 지정합니다.

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

-DataCollection

데이터 컬렉션 형식을 지정합니다. 이 매개 변수에 허용되는 값은 사용 및 사용 안 함입니다.

Type:String
Accepted values:Enable, Disable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

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

-Location

리소스 확장의 경로를 지정합니다.

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

-Name

확장을 나타내는 Azure Resource Manager 리소스의 이름을 지정합니다. 기본값은 Microsoft.Powershell.DSC입니다.

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

-NoWait

작업을 시작하고 작업이 완료되기 전에 즉시 반환합니다. 작업이 성공적으로 완료되었는지 확인하려면 다른 메커니즘을 사용합니다.

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

-ResourceGroupName

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

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

-Version

Set-AzVMDscExtension이 설정을 적용하는 DSC 확장의 버전을 지정합니다.

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

-VMName

DSC 확장 처리기가 설치된 가상 머신의 이름을 지정합니다.

Type:String
Position:3
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 버전을 지정합니다.

Type:String
Accepted values:4.0, 5.0, 5.1, latest
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

입력

String

Hashtable

출력

PSAzureOperationResponse