Sdílet prostřednictvím


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