Add-AzureProvisioningConfig

참조

모듈:: Azure

Azure 가상 머신에 대한 프로비저닝 구성을 추가합니다.

참고 항목

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

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

구문

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-Windows]
   [-AdminUsername <String>]
   [-Password <String>]
   [-ResetPasswordOnFirstLogon]
   [-DisableAutomaticUpdates]
   [-NoRDPEndpoint]
   [-TimeZone <String>]
   [-Certificates <CertificateSettingList>]
   [-EnableWinRMHttp]
   [-DisableWinRMHttps]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-Linux]
   [-LinuxUser <String>]
   [-DisableSSH]
   [-NoSSHEndpoint]
   [-NoSSHPassword]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-CustomDataFile <String>]
   [-Password <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   -AdminUsername <String>
   [-WindowsDomain]
   [-Password <String>]
   [-ResetPasswordOnFirstLogon]
   [-DisableAutomaticUpdates]
   [-NoRDPEndpoint]
   [-TimeZone <String>]
   [-Certificates <CertificateSettingList>]
   -JoinDomain <String>
   -Domain <String>
   -DomainUserName <String>
   -DomainPassword <String>
   [-MachineObjectOU <String>]
   [-EnableWinRMHttp]
   [-DisableWinRMHttps]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Add-AzureProvisioningConfig cmdlet은 Azure 가상 머신 구성에 프로비전 구성 정보를 추가합니다. 구성 개체를 사용하여 가상 머신을 만들 수 있습니다.

이 cmdlet은 독립 실행형 Windows 서버, Active Directory 도메인에 가입된 Windows 서버 및 Linux 기반 서버를 비롯한 다양한 프로비저닝 구성을 지원합니다.

Active Directory 도메인 가입 서버를 만들려면 Active Directory 도메인의 정규화된 도메인 이름과 가상 머신을 도메인에 가입할 수 있는 권한이 있는 사용자의 도메인 자격 증명을 지정합니다.

예제

예제 1: 독립 실행형 가상 머신 만들기

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"

이 명령은 New-AzureVMConfig cmdlet을 사용하여 가상 머신 구성 개체를 만듭니다. 이 명령은 파이프라인 연산자를 사용하여 해당 개체를 현재 cmdlet에 전달합니다. 현재 cmdlet은 Windows 운영 체제를 실행하는 가상 머신에 대한 프로비저닝 구성을 추가합니다. 구성에는 관리자 사용자 이름 및 암호가 포함됩니다. 이 명령은 가상 머신을 만드는 New-AzureVM cmdlet에 구성을 전달합니다.

예제 2: 도메인에 가입된 가상 머신 만들기

PS C:\> New-AzureVMConfig -Name "DomainVM" -InstanceSize Small -ImageName "Image09" | Add-AzureProvisioningConfig -WindowsDomain -Password "password" -AdminUsername "AdminMain" -ResetPasswordOnFirstLogon -JoinDomain "contoso.com" -Domain "contoso" -DomainUserName "DomainAdminUser" -DomainPassword "DomainPassword" -MachineObjectOU 'OU=AzureVMs,DC=contoso,DC=com' | New-AzureVM -ServiceName "ContosoService"

이 명령은 가상 머신 구성 개체를 만든 다음 현재 cmdlet에 전달합니다. 현재 cmdlet은 contoso 도메인과 조인할 가상 머신에 대한 프로비저닝 구성을 추가합니다. 이 명령에는 가상 머신을 도메인에 가입하는 데 필요한 사용자 이름 및 암호가 포함됩니다. 구성을 사용하려면 사용자가 첫 번째 로그온 시 사용자 암호를 변경해야 합니다. 이 명령은 프로비전 개체를 기반으로 가상 머신을 만듭니다.

예제 3: Linux 기반 가상 머신 만들기

PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"

이 명령은 가상 머신 구성 개체를 만든 다음 현재 cmdlet에 전달합니다. 현재 cmdlet은 Linux 운영 체제를 실행하는 가상 머신에 대한 프로비저닝 구성을 추가합니다. 구성에는 루트 사용자 이름 및 암호가 포함됩니다. 이 명령은 프로비전 개체를 기반으로 가상 머신을 만듭니다.

예제 4: WinRM용 인증서를 포함하는 가상 머신 만들기

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image11" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

첫 번째 명령은 인증서 저장소에서 인증서를 가져오고 $certs 배열 변수에 저장합니다.

두 번째 명령은 가상 머신 구성 개체를 만든 다음 현재 cmdlet에 전달합니다. 현재 cmdlet은 WinRM에 대한 인증서를 포함하는 프로비저닝 구성을 추가합니다. 이 명령은 프로비전 개체를 기반으로 가상 머신을 만듭니다.

예제 5: HTTP를 통해 WinRM을 사용하도록 설정된 가상 머신 만들기

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

이 명령은 가상 머신 구성 개체를 만든 다음 현재 cmdlet에 전달합니다. 현재 cmdlet은 HTTP를 통해 WinRM을 사용하도록 설정된 프로비저닝 구성을 추가합니다. 이 명령은 프로비전 개체를 기반으로 가상 머신을 만듭니다.

예제 6: HTTPS를 통해 WinRM을 사용하지 않도록 설정된 가상 머신 만들기

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

이 명령은 가상 머신 구성 개체를 만든 다음 현재 cmdlet에 전달합니다. 현재 cmdlet은 HTTPS를 통해 WinRM을 사용하지 않도록 설정하는 프로비저닝 구성을 추가합니다. 이 명령은 프로비전 개체를 기반으로 가상 머신을 만듭니다.

예제 7: 키 내보내기 없이 가상 머신 만들기

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -X509Certificates $certs[0], $certs[1] -NoExportPrivateKey | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

첫 번째 명령은 인증서 저장소에서 인증서를 가져오고 $certs 배열 변수에 저장합니다.

두 번째 명령은 가상 머신 구성 개체를 만든 다음 현재 cmdlet에 전달합니다. 현재 cmdlet은 인증서를 포함하고 프라이빗 키를 내보내지 않는 가상 머신에 대한 프로비저닝 구성을 추가합니다. 이 명령은 프로비전 개체를 기반으로 가상 머신을 만듭니다.

매개 변수

-AdminUsername

이 구성이 가상 머신에서 만드는 관리자 계정의 사용자 이름을 지정합니다.

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

-Certificates

이 구성이 가상 머신에 설치하는 인증서 집합을 지정합니다.

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

-CustomDataFile

가상 머신의 데이터 파일을 지정합니다. 이 cmdlet은 파일의 내용을 Base64로 인코딩합니다. 파일 길이는 64킬로바이트 미만이어야 합니다.

게스트 운영 체제가 Windows 운영 체제인 경우 이 구성은 이 데이터를 %SYSTEMDRIVE%\AzureData\CustomData.bin 이진 파일로 저장합니다.

게스트 운영 체제가 Linux인 경우 이 구성은 ovf-env.xml 파일을 사용하여 데이터를 전달합니다. 구성은 해당 파일을 /var/lib/waagent 디렉터리에 복사합니다. 또한 에이전트는 Base64로 인코딩된 데이터를 /var/lib/waagent/CustomData에 저장합니다.

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

-DisableAutomaticUpdates

이 구성은 자동 업데이트를 사용하지 않도록 설정함을 나타냅니다.

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

-DisableGuestAgent

이 구성은 IaaS(Infrastructure as a Service) 게스트 에이전트를 사용하지 않도록 설정함을 나타냅니다.

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

-DisableSSH

이 구성이 SSH를 사용하지 않도록 설정함을 나타냅니다.

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

-DisableWinRMHttps

이 구성은 HTTPS에서 WinRM(Windows 원격 관리)을 사용하지 않도록 설정함을 나타냅니다. 기본적으로 WinRM은 HTTPS를 통해 사용하도록 설정됩니다.

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

-Domain

도메인에 컴퓨터를 추가할 수 있는 권한이 있는 계정의 도메인 이름을 지정합니다.

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

-DomainPassword

도메인에 컴퓨터를 추가할 수 있는 권한이 있는 사용자 계정의 암호를 지정합니다.

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

-DomainUserName

도메인에 컴퓨터를 추가할 수 있는 권한이 있는 사용자 계정의 이름을 지정합니다.

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

-EnableWinRMHttp

이 구성이 HTTP를 통해 WinRM을 사용하도록 설정했음을 나타냅니다.

형식:	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

-JoinDomain

가입할 도메인의 FQDN(정규화된 도메인 이름)을 지정합니다.

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

-Linux

이 구성이 Linux 구성을 만든다는 것을 나타냅니다.

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

-LinuxUser

이 구성이 가상 머신에서 만드는 Linux 관리 계정의 사용자 이름을 지정합니다.

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

-MachineObjectOU

구성에서 컴퓨터 계정을 만드는 OU(조직 구성 단위)의 정규화된 이름을 지정합니다.

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

-NoExportPrivateKey

이 구성이 프라이빗 키를 업로드하지 않음을 나타냅니다.

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

-NoRDPEndpoint

이 구성은 원격 데스크톱 엔드포인트 없이 가상 머신을 만듭니다.

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

-NoSSHEndpoint

이 구성은 SSH 엔드포인트 없이 가상 머신을 만듭니다.

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

-NoSSHPassword

이 구성은 SSH 암호 없이 가상 머신을 만듭니다.

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

-NoWinRMEndpoint

이 구성은 가상 머신에 대한 WinRM 엔드포인트를 추가하지 않음을 나타냅니다.

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

-Password

관리자 계정의 암호를 지정합니다.

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

-Profile

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

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

-ResetPasswordOnFirstLogon

가상 머신에서 사용자가 첫 번째 로그온 시 암호를 변경해야 했음을 나타냅니다.

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

-SSHKeyPairs

SSH 키 쌍을 지정합니다.

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

-SSHPublicKeys

SSH 공개 키를 지정합니다.

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

-TimeZone

가상 머신의 표준 시간대(예: 태평양 표준시 또는 캐나다 중부 표준시)를 지정합니다.

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

-VM

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

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

-Windows

이 구성은 Windows 운영 체제를 실행하는 독립 실행형 가상 머신을 만듭니다.

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

-WindowsDomain

이 구성은 Active Directory 도메인에 조인된 Windows 서버를 만듭니다.

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

-WinRMCertificate

이 구성이 WinRM 엔드포인트에 연결하는 인증서를 지정합니다.

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

-X509Certificates

호스트된 서비스에 배포되는 X509 인증서의 배열을 지정합니다.

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

다음을 통해 공유