Add-AzureProvisioningConfig

Başvuru

Modül:: Azure

Azure sanal makinesi için sağlama yapılandırması ekler.

Not

Bu belgelerde başvuruda bulunan cmdlet'ler, Hizmet Yönetimi API'lerini kullanan eski Azure kaynaklarını yönetmeye yöneliktir. Azure Resource Manager kaynaklarını yönetmek için cmdlet'ler için Az PowerShell modülüne bakın.

Syntax

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'i, azure sanal makine yapılandırmasına sağlama yapılandırma bilgileri ekler. Sanal makine oluşturmak için yapılandırma nesnesini kullanabilirsiniz.

Bu cmdlet, tek başına Windows sunucuları, Active Directory etki alanına katılmış Windows sunucuları ve Linux tabanlı sunucular gibi farklı sağlama yapılandırmalarını destekler.

Active Directory etki alanına katılmış bir sunucu oluşturmak için, Active Directory etki alanının tam etki alanı adını ve sanal makineyi etki alanına ekleme izni olan bir kullanıcının etki alanı kimlik bilgilerini belirtin.

Örnekler

Örnek 1: Tek başına sanal makine oluşturma

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

Bu komut, New-AzureVMConfig cmdlet'ini kullanarak bir sanal makine yapılandırma nesnesi oluşturur. Komut, işlem hattı işlecini kullanarak bu nesneyi geçerli cmdlet'e geçirir. Geçerli cmdlet, Windows işletim sistemini çalıştıran bir sanal makine için sağlama yapılandırması ekler. Yapılandırma yönetici kullanıcı adını ve parolasını içerir. komutu, yapılandırmayı sanal makineyi oluşturan New-AzureVM cmdlet'ine geçirir.

Örnek 2: Etki alanına katılmış sanal makine oluşturma

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"

Bu komut bir sanal makine yapılandırma nesnesi oluşturur ve bunu geçerli cmdlet'e geçirir. Geçerli cmdlet, contoso etki alanıyla birleştirilecek bir sanal makine için sağlama yapılandırması ekler. komutu, sanal makineyi etki alanına eklemek için gereken kullanıcı adını ve parolayı içerir. Yapılandırma, kullanıcının ilk oturum açmada kullanıcı parolasını değiştirmesini gerektirir. komutu, sağlama nesnesine göre sanal makineyi oluşturur.

Örnek 3: Linux tabanlı sanal makine oluşturma

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

Bu komut bir sanal makine yapılandırma nesnesi oluşturur ve bunu geçerli cmdlet'e geçirir. Geçerli cmdlet, Linux işletim sistemini çalıştıran bir sanal makine için sağlama yapılandırması ekler. Yapılandırma, kök kullanıcı adını ve parolayı içerir. komutu, sağlama nesnesine göre sanal makineyi oluşturur.

Örnek 4: WinRM sertifikaları içeren bir sanal makine oluşturma

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

İlk komut sertifika deposundan sertifikaları alır ve sonra bunları $certs dizi değişkeninde depolar.

İkinci komut bir sanal makine yapılandırma nesnesi oluşturur ve bunu geçerli cmdlet'e geçirir. Geçerli cmdlet, WinRM sertifikalarını içeren sağlama yapılandırması ekler. komutu, sağlama nesnesine göre sanal makineyi oluşturur.

Örnek 5: HTTP üzerinden WinRM'nin etkinleştirildiği bir sanal makine oluşturma

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

Bu komut bir sanal makine yapılandırma nesnesi oluşturur ve bunu geçerli cmdlet'e geçirir. Geçerli cmdlet, HTTP üzerinden WinRM'nin etkinleştirildiği sağlama yapılandırması ekler. komutu, sağlama nesnesine göre sanal makineyi oluşturur.

Örnek 6: HTTPS üzerinden WinRM'nin devre dışı bırakıldığını gösteren bir sanal makine oluşturma

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

Bu komut bir sanal makine yapılandırma nesnesi oluşturur ve bunu geçerli cmdlet'e geçirir. Geçerli cmdlet, HTTPS üzerinden WinRM'yi devre dışı bırakan sağlama yapılandırması ekler. komutu, sağlama nesnesine göre sanal makineyi oluşturur.

Örnek 7: Anahtar dışarı aktarma olmadan sanal makine oluşturma

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

İlk komut sertifika deposundan sertifikaları alır ve sonra bunları $certs dizi değişkeninde depolar.

İkinci komut bir sanal makine yapılandırma nesnesi oluşturur ve bunu geçerli cmdlet'e geçirir. Geçerli cmdlet sertifikaları içeren ve özel anahtarları dışarı aktarmayan bir sanal makine için sağlama yapılandırması ekler. komutu, sağlama nesnesine göre sanal makineyi oluşturur.

Parametreler

-AdminUsername

Bu yapılandırmanın sanal makinede oluşturduğu Yönetici hesabının kullanıcı adını belirtir.

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

-Certificates

Bu yapılandırmanın sanal makineye yüklediği bir sertifika kümesini belirtir.

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

-CustomDataFile

Sanal makine için bir veri dosyası belirtir. Bu cmdlet dosyanın içeriğini Base64 olarak kodlar. Dosya 64 kilobayttan kısa olmalıdır.

Konuk işletim sistemi Windows işletim sistemiyse, bu yapılandırma bu verileri %SYSTEMDRIVE%\AzureData\CustomData.bin adlı bir ikili dosya olarak kaydeder.

Konuk işletim sistemi Linux ise, bu yapılandırma ovf-env.xml dosyasını kullanarak verileri geçirir. Yapılandırma bu dosyayı /var/lib/waagent dizinine kopyalar. Aracı ayrıca Base64 ile kodlanmış verileri /var/lib/waagent/CustomData içinde depolar.

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

-DisableAutomaticUpdates

Bu yapılandırmanın otomatik güncelleştirmeleri devre dışı bırakdığını gösterir.

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

-DisableGuestAgent

Bu yapılandırmanın hizmet olarak altyapı (IaaS) konuk aracısını devre dışı bırakdığını gösterir.

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

-DisableSSH

Bu yapılandırmanın SSH'yi devre dışı bırakdığını gösterir.

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

-DisableWinRMHttps

Bu yapılandırmanın HTTPS üzerinde Windows Uzaktan Yönetimi'nin (WinRM) devre dışı bırakıldığını gösterir. Varsayılan olarak, WinRM HTTPS üzerinden etkinleştirilir.

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

-Domain

Bilgisayarı bir etki alanına ekleme izni olan hesabın etki alanının adını belirtir.

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

-DomainPassword

Bilgisayarı bir etki alanına ekleme izni olan kullanıcı hesabının parolasını belirtir.

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

-DomainUserName

Bilgisayarı bir etki alanına ekleme izni olan kullanıcı hesabının adını belirtir.

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

-EnableWinRMHttp

Bu yapılandırmanın HTTP üzerinden WinRM'ye olanak sağladığını gösterir.

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

-InformationAction

Bu cmdlet'in bir bilgi olayına nasıl yanıt vereceğini belirtir.

Bu parametre için kabul edilebilir değerler şunlardır:

Devam
Yoksay
Sorgulamak
SilentlyContinue
Durdur
Askıya Alma

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Bir bilgi değişkeni belirtir.

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

-JoinDomain

Katılacağınız etki alanının tam etki alanı adını (FQDN) belirtir.

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

-Linux

Bu yapılandırmanın bir Linux yapılandırması oluşturduğunu gösterir.

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

-LinuxUser

Bu yapılandırmanın sanal makinede oluşturduğu Linux yönetim hesabının kullanıcı adını belirtir.

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

-MachineObjectOU

Yapılandırmanın bilgisayar hesabını oluşturduğu kuruluş biriminin (OU) tam adını belirtir.

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

-NoExportPrivateKey

Bu yapılandırmanın özel anahtarı karşıya yüklemediğini gösterir.

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

-NoRDPEndpoint

Bu yapılandırmanın uzak masaüstü uç noktası olmayan bir sanal makine oluşturduğunu gösterir.

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

-NoSSHEndpoint

Bu yapılandırmanın SSH uç noktası olmayan bir sanal makine oluşturduğunu gösterir.

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

-NoSSHPassword

Bu yapılandırmanın SSH parolası olmadan bir sanal makine oluşturduğunu gösterir.

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

-NoWinRMEndpoint

Bu yapılandırmanın sanal makine için bir WinRM uç noktası eklemediğini gösterir.

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

-Password

Yönetici hesabının parolasını belirtir.

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

-Profile

Bu cmdlet'in okuduğu Azure profilini belirtir. Bir profil belirtmezseniz, bu cmdlet yerel varsayılan profilden okur.

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

-ResetPasswordOnFirstLogon

Sanal makinenin, kullanıcının ilk oturum açmada parolayı değiştirmesini gerektirdiğini gösterir.

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

-SSHKeyPairs

SSH anahtar çiftlerini belirtir.

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

-SSHPublicKeys

SSH ortak anahtarlarını belirtir.

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

-TimeZone

Sanal makinenin saat dilimini belirtir; örneğin, Pasifik Standart Saati veya Kanada Orta Standart Saati.

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

-VM

Bir sanal makine nesnesi belirtir.

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

-Windows

Bu yapılandırmanın, Windows işletim sistemini çalıştıran tek başına bir sanal makine oluşturduğunu gösterir.

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

-WindowsDomain

Bu yapılandırmanın bir Active Directory etki alanına katılmış Windows sunucusu oluşturduğunu gösterir.

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

-WinRMCertificate

Bu yapılandırmanın bir WinRM uç noktasıyla ilişkilendirdiğini bir sertifika belirtir.

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

-X509Certificates

Barındırılan bir hizmete dağıtılan X509 sertifika dizisini belirtir.

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Share via