Add-AzureProvisioningConfig
Üzembe helyezési konfigurációt ad hozzá egy Azure-beli virtuális géphez.
Feljegyzés
A jelen dokumentációban hivatkozott parancsmagok az Azure Service Manager (ASM) API-kat használó örökölt Azure-erőforrások kezelésére szolgálnak. Ez az örökölt PowerShell-modul nem ajánlott új erőforrások létrehozásakor, mivel az ASM a kivonásra van ütemezve. További információkért lásd az Azure Service Manager kivonását.
Az Az PowerShell-modul az ajánlott PowerShell-modul az Azure Resource Manager-erőforrások PowerShell-lel való kezeléséhez.
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
Az Add-AzureProvisioningConfig parancsmag kiépítési konfigurációs információkat ad hozzá egy Azure-beli virtuális gép konfigurációhoz. A konfigurációs objektummal virtuális gépet hozhat létre.
Ez a parancsmag különböző kiépítési konfigurációkat támogat, beleértve az önálló Windows-kiszolgálókat, az Active Directory-tartományhoz csatlakoztatott Windows-kiszolgálókat és a Linux-alapú kiszolgálókat.
Active Directory-tartományhoz csatlakoztatott kiszolgáló létrehozásához adja meg az Active Directory-tartomány teljes tartománynevét és a tartomány hitelesítő adatait annak a felhasználónak, aki jogosult csatlakozni a virtuális géphez a tartományhoz.
Példák
1. példa: Önálló virtuális gép létrehozása
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"
Ez a parancs létrehoz egy virtuálisgép-konfigurációs objektumot a New-AzureVMConfig parancsmag használatával. A parancs a folyamatkezelővel továbbítja az objektumot az aktuális parancsmagnak. Az aktuális parancsmag kiépítési konfigurációt ad hozzá a Windows operációs rendszert futtató virtuális gépekhez. A konfiguráció tartalmazza a rendszergazda felhasználónevet és jelszót. A parancs átadja a konfigurációt a New-AzureVM parancsmagnak, amely létrehozza a virtuális gépet.
2. példa: Tartományhoz csatlakoztatott virtuális gép létrehozása
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"
Ez a parancs létrehoz egy virtuálisgép-konfigurációs objektumot, majd átadja az aktuális parancsmagnak. Az aktuális parancsmag kiépítési konfigurációt ad hozzá a contoso tartományhoz csatlakoztatni kívánt virtuális géphez. A parancs tartalmazza a virtuális gép tartományhoz való csatlakoztatásához szükséges felhasználónevet és jelszót. A konfigurációhoz a felhasználónak módosítania kell a felhasználói jelszót az első bejelentkezéskor. A parancs a kiépítési objektum alapján hozza létre a virtuális gépet.
3. példa: Linux-alapú virtuális gép létrehozása
PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"
Ez a parancs létrehoz egy virtuálisgép-konfigurációs objektumot, majd átadja az aktuális parancsmagnak. Az aktuális parancsmag kiépítési konfigurációt ad hozzá a Linux operációs rendszert futtató virtuális gépekhez. A konfiguráció tartalmazza a legfelső szintű felhasználónevet és jelszót. A parancs a kiépítési objektum alapján hozza létre a virtuális gépet.
4. példa: WinRM-tanúsítványokat tartalmazó virtuális gép létrehozása
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
Az első parancs lekéri a tanúsítványokat egy tanúsítványtárolóból, majd a $certs tömbváltozóban tárolja őket.
A második parancs létrehoz egy virtuálisgép-konfigurációs objektumot, majd átadja az aktuális parancsmagnak. Az aktuális parancsmag olyan kiépítési konfigurációt ad hozzá, amely tanúsítványokat tartalmaz a WinRM-hez. A parancs a kiépítési objektum alapján hozza létre a virtuális gépet.
5. példa: WinRM-kompatibilis virtuális gép létrehozása HTTP-en keresztül
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Ez a parancs létrehoz egy virtuálisgép-konfigurációs objektumot, majd átadja az aktuális parancsmagnak. Az aktuális parancsmag olyan kiépítési konfigurációt ad hozzá, amely engedélyezve van a WinRM-ben HTTP-en keresztül. A parancs a kiépítési objektum alapján hozza létre a virtuális gépet.
6. példa: Olyan virtuális gép létrehozása, amelyben a WinRM le van tiltva HTTPS-en keresztül
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Ez a parancs létrehoz egy virtuálisgép-konfigurációs objektumot, majd átadja az aktuális parancsmagnak. Az aktuális parancsmag olyan kiépítési konfigurációt ad hozzá, amely letiltja a WinRM-et HTTPS-en keresztül. A parancs a kiépítési objektum alapján hozza létre a virtuális gépet.
7. példa: Kulcsexportálással nem rendelkező virtuális gép létrehozása
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
Az első parancs lekéri a tanúsítványokat egy tanúsítványtárolóból, majd a $certs tömbváltozóban tárolja őket.
A második parancs létrehoz egy virtuálisgép-konfigurációs objektumot, majd átadja az aktuális parancsmagnak. Az aktuális parancsmag kiépítési konfigurációt ad hozzá egy olyan virtuális géphez, amely tanúsítványokat tartalmaz, és nem exportál titkos kulcsokat. A parancs a kiépítési objektum alapján hozza létre a virtuális gépet.
Paraméterek
-AdminUsername
Megadja annak a rendszergazdai fióknak a felhasználónevét, amelyet ez a konfiguráció a virtuális gépen hoz létre.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Certificates
A konfiguráció által a virtuális gépre telepített tanúsítványok készletét adja meg.
Típus: | CertificateSettingList |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-CustomDataFile
Megadja a virtuális gép adatfájlját. Ez a parancsmag a fájl tartalmát Base64-ként kódolja. A fájlnak 64 kilobájtnál rövidebbnek kell lennie.
Ha a vendég operációs rendszer a Windows operációs rendszer, ez a konfiguráció a következő bináris fájlként menti az adatokat: %SYSTEMDRIVE%\AzureData\CustomData.bin.
Ha a vendég operációs rendszer Linux, ez a konfiguráció a ovf-env.xml fájl használatával továbbítja az adatokat. A konfiguráció a fájlt a /var/lib/waagent könyvtárba másolja. Az ügynök a Base64 kódolású adatait is a /var/lib/waagent/CustomData fájlban tárolja.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisableAutomaticUpdates
Azt jelzi, hogy ez a konfiguráció letiltja az automatikus frissítéseket.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisableGuestAgent
Azt jelzi, hogy ez a konfiguráció letiltja az infrastruktúrát szolgáltatásként (IaaS) vendégügynökként.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisableSSH
Azt jelzi, hogy ez a konfiguráció letiltja az SSH-t.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisableWinRMHttps
Azt jelzi, hogy ez a konfiguráció letiltja a Windows Remote Managementet (WinRM) a HTTPS-en. Alapértelmezés szerint a WinRM engedélyezve van HTTPS-en keresztül.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Domain
Annak a fióknak a nevét adja meg, amely jogosult a számítógép tartományhoz való hozzáadására.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DomainPassword
Megadja annak a felhasználói fióknak a jelszavát, amely jogosult a számítógép tartományhoz való hozzáadására.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DomainUserName
Megadja annak a felhasználói fióknak a nevét, amely jogosult a számítógép tartományhoz való hozzáadására.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-EnableWinRMHttp
Azt jelzi, hogy ez a konfiguráció lehetővé teszi a WinRM http-en keresztüli használatát.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-InformationAction
Meghatározza, hogy ez a parancsmag hogyan reagál egy információs eseményre.
A paraméter elfogadható értékei a következők:
- Folytatás
- Mellőzés
- Érdeklődik
- SilentlyContinue
- Leállítás
- Felfüggesztés
Típus: | ActionPreference |
Aliasok: | infa |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-InformationVariable
Egy információs változót ad meg.
Típus: | String |
Aliasok: | iv |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-JoinDomain
Megadja a csatlakoztatni kívánt tartomány teljes tartománynevét (FQDN).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Linux
Azt jelzi, hogy ez a konfiguráció létrehoz egy Linux-konfigurációt.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-LinuxUser
Megadja annak a Linux felügyeleti fióknak a felhasználónevét, amelyet ez a konfiguráció hoz létre a virtuális gépen.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-MachineObjectOU
Megadja annak a szervezeti egységnek (szervezeti egységnek) a teljes nevét, amelyben a konfiguráció létrehozza a számítógépfiókot.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-NoExportPrivateKey
Azt jelzi, hogy ez a konfiguráció nem tölti fel a titkos kulcsot.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-NoRDPEndpoint
Azt jelzi, hogy ez a konfiguráció távoli asztali végpont nélkül hoz létre virtuális gépet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-NoSSHEndpoint
Azt jelzi, hogy ez a konfiguráció SSH-végpont nélkül hoz létre virtuális gépet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-NoSSHPassword
Azt jelzi, hogy ez a konfiguráció SSH-jelszó nélküli virtuális gépet hoz létre.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-NoWinRMEndpoint
Azt jelzi, hogy ez a konfiguráció nem ad hozzá WinRM-végpontot a virtuális géphez.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Password
Megadja a rendszergazdai fiók jelszavát.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Profile
Azt az Azure-profilt adja meg, amelyből a parancsmag beolvassa. Ha nem ad meg profilt, ez a parancsmag a helyi alapértelmezett profilból olvas be.
Típus: | AzureSMProfile |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ResetPasswordOnFirstLogon
Azt jelzi, hogy a virtuális gép megköveteli a felhasználótól, hogy az első bejelentkezéskor módosítsa a jelszót.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SSHKeyPairs
SSH-kulcspárokat határoz meg.
Típus: | SSHKeyPairList |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SSHPublicKeys
Nyilvános SSH-kulcsokat ad meg.
Típus: | SSHPublicKeyList |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-TimeZone
Megadja a virtuális gép időzónáját, például a Csendes-óceáni téli idő vagy a Kanada középső téli idejét.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-VM
Egy virtuálisgép-objektumot határoz meg.
Típus: | IPersistentVM |
Aliasok: | InputObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Windows
Azt jelzi, hogy ez a konfiguráció létrehoz egy különálló virtuális gépet, amely a Windows operációs rendszert futtatja.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WindowsDomain
Azt jelzi, hogy ez a konfiguráció egy Active Directory-tartományhoz csatlakoztatott Windows-kiszolgálót hoz létre.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WinRMCertificate
Egy tanúsítványt ad meg, amelyet ez a konfiguráció egy WinRM-végponthoz társít.
Típus: | X509Certificate2 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-X509Certificates
Egy üzemeltetett szolgáltatásban üzembe helyezett X509-tanúsítványok tömbje.
Típus: | X509Certificate2[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |