Add-AzureProvisioningConfig
Přidá konfiguraci zřizování pro virtuální počítač Azure.
Poznámka:
Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.
Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.
Syntaxe
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
Rutina Add-AzureProvisioningConfig přidává informace o konfiguraci zřizování do konfigurace virtuálního počítače Azure. Objekt konfigurace můžete použít k vytvoření virtuálního počítače.
Tato rutina podporuje různé konfigurace zřizování, včetně samostatných serverů s Windows, serverů Windows připojených k doméně služby Active Directory a serverů založených na Linuxu.
Pokud chcete vytvořit server připojený k doméně služby Active Directory, zadejte plně kvalifikovaný název domény domény služby Active Directory a přihlašovací údaje domény uživatele, který má oprávnění připojit virtuální počítač k doméně.
Příklady
Příklad 1: Vytvoření samostatného virtuálního počítače
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"
Tento příkaz vytvoří objekt konfigurace virtuálního počítače pomocí rutiny New-AzureVMConfig . Příkaz předá tento objekt aktuální rutině pomocí operátoru kanálu. Aktuální rutina přidává konfiguraci zřizování pro virtuální počítač, na kterém běží operační systém Windows. Konfigurace zahrnuje uživatelské jméno a heslo správce. Příkaz předá konfiguraci rutině New-AzureVM , která vytvoří virtuální počítač.
Příklad 2: Vytvoření virtuálního počítače připojeného k doméně
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"
Tento příkaz vytvoří objekt konfigurace virtuálního počítače a pak ho předá aktuální rutině. Aktuální rutina přidá konfiguraci zřizování pro virtuální počítač, který se má připojit k doméně contoso. Příkaz obsahuje uživatelské jméno a heslo potřebné pro připojení virtuálního počítače k doméně. Konfigurace vyžaduje, aby uživatel při prvním přihlášení změnil heslo uživatele. Příkaz vytvoří virtuální počítač na základě objektu zřizování.
Příklad 3: Vytvoření virtuálního počítače s Linuxem
PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"
Tento příkaz vytvoří objekt konfigurace virtuálního počítače a pak ho předá aktuální rutině. Aktuální rutina přidává konfiguraci zřizování pro virtuální počítač, na kterém běží operační systém Linux. Konfigurace zahrnuje kořenové uživatelské jméno a heslo. Příkaz vytvoří virtuální počítač na základě objektu zřizování.
Příklad 4: Vytvoření virtuálního počítače, který obsahuje certifikáty pro 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
První příkaz získá certifikáty z úložiště certifikátů a pak je uloží do proměnné pole $certs.
Druhý příkaz vytvoří objekt konfigurace virtuálního počítače a pak ho předá aktuální rutině. Aktuální rutina přidá konfiguraci zřizování, která zahrnuje certifikáty pro WinRM. Příkaz vytvoří virtuální počítač na základě objektu zřizování.
Příklad 5: Vytvoření virtuálního počítače s povoleným WinRM přes PROTOKOL HTTP
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Tento příkaz vytvoří objekt konfigurace virtuálního počítače a pak ho předá aktuální rutině. Aktuální rutina přidává konfiguraci zřizování, která má povolenou službu WinRM přes PROTOKOL HTTP. Příkaz vytvoří virtuální počítač na základě objektu zřizování.
Příklad 6: Vytvoření virtuálního počítače, který má zakázaný WinRM přes HTTPS
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Tento příkaz vytvoří objekt konfigurace virtuálního počítače a pak ho předá aktuální rutině. Aktuální rutina přidá konfiguraci zřizování, která zakáže WinRM přes HTTPS. Příkaz vytvoří virtuální počítač na základě objektu zřizování.
Příklad 7: Vytvoření virtuálního počítače bez exportu klíče
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
První příkaz získá certifikáty z úložiště certifikátů a pak je uloží do proměnné pole $certs.
Druhý příkaz vytvoří objekt konfigurace virtuálního počítače a pak ho předá aktuální rutině. Aktuální rutina přidává konfiguraci zřizování pro virtuální počítač, který obsahuje certifikáty a neexportuje privátní klíče. Příkaz vytvoří virtuální počítač na základě objektu zřizování.
Parametry
-AdminUsername
Určuje uživatelské jméno účtu správce, který tato konfigurace vytvoří na virtuálním počítači.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Certificates
Určuje sadu certifikátů, které tato konfigurace nainstaluje na virtuální počítač.
Typ: | CertificateSettingList |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CustomDataFile
Určuje datový soubor pro virtuální počítač. Tato rutina kóduje obsah souboru jako Base64. Soubor musí být kratší než 64 kilobajtů.
Pokud je hostovaný operační systém operační systém Windows, tato konfigurace uloží tato data jako binární soubor s názvem %SYSTEMDRIVE%\AzureData\CustomData.bin.
Pokud je hostovaný operační systém Linux, tato konfigurace předává data pomocí souboru ovf-env.xml. Konfigurace zkopíruje tento soubor do adresáře /var/lib/waagent. Agent také ukládá data zakódovaná v base64 do /var/lib/waagent/CustomData.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisableAutomaticUpdates
Označuje, že tato konfigurace zakáže automatické aktualizace.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisableGuestAgent
Označuje, že tato konfigurace zakáže agenta hosta infrastruktury jako služby (IaaS).
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisableSSH
Označuje, že tato konfigurace zakáže SSH.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisableWinRMHttps
Označuje, že tato konfigurace zakáže vzdálenou správu systému Windows (WinRM) na protokolu HTTPS. Ve výchozím nastavení je WinRM povolený přes PROTOKOL HTTPS.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Domain
Určuje název domény účtu, který má oprávnění k přidání počítače do domény.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DomainPassword
Určuje heslo uživatelského účtu, který má oprávnění k přidání počítače do domény.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DomainUserName
Určuje název uživatelského účtu, který má oprávnění k přidání počítače do domény.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-EnableWinRMHttp
Označuje, že tato konfigurace umožňuje WinRM přes HTTP.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InformationAction
Určuje, jak tato rutina reaguje na informační událost.
Tento parametr přijímá tyto hodnoty:
- Pokračovat
- Ignorovat
- Informovat se
- SilentlyContinue
- Zastavit
- Suspend
Typ: | ActionPreference |
Aliasy: | infa |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InformationVariable
Určuje informační proměnnou.
Typ: | String |
Aliasy: | iv |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-JoinDomain
Určuje plně kvalifikovaný název domény (FQDN) domény, ke které se má připojit.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Linux
Označuje, že tato konfigurace vytvoří konfiguraci Linuxu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-LinuxUser
Určuje uživatelské jméno účtu pro správu Linuxu, který tato konfigurace vytvoří na virtuálním počítači.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-MachineObjectOU
Určuje plně kvalifikovaný název organizační jednotky(OU), ve které konfigurace vytvoří účet počítače.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NoExportPrivateKey
Označuje, že tato konfigurace nenahrá privátní klíč.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NoRDPEndpoint
Označuje, že tato konfigurace vytvoří virtuální počítač bez koncového bodu vzdálené plochy.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NoSSHEndpoint
Označuje, že tato konfigurace vytvoří virtuální počítač bez koncového bodu SSH.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NoSSHPassword
Označuje, že tato konfigurace vytvoří virtuální počítač bez hesla SSH.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NoWinRMEndpoint
Označuje, že tato konfigurace nepřidá koncový bod WinRM pro virtuální počítač.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Password
Určuje heslo účtu správce.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Profile
Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.
Typ: | AzureSMProfile |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResetPasswordOnFirstLogon
Označuje, že virtuální počítač vyžaduje, aby uživatel při prvním přihlášení změnil heslo.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-SSHKeyPairs
Určuje páry klíčů SSH.
Typ: | SSHKeyPairList |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-SSHPublicKeys
Určuje veřejné klíče SSH.
Typ: | SSHPublicKeyList |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-TimeZone
Určuje časové pásmo pro virtuální počítač, například Tichomoří (běžný čas) nebo Kanada – středový běžný čas.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VM
Určuje objekt virtuálního počítače.
Typ: | IPersistentVM |
Aliasy: | InputObject |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Windows
Označuje, že tato konfigurace vytvoří samostatný virtuální počítač, na kterém běží operační systém Windows.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WindowsDomain
Označuje, že tato konfigurace vytvoří server Windows, který je připojený k doméně služby Active Directory.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WinRMCertificate
Určuje certifikát, který tato konfigurace přidruží ke koncovému bodu WinRM.
Typ: | X509Certificate2 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-X509Certificates
Určuje pole certifikátů X509 nasazených do hostované služby.
Typ: | X509Certificate2[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |