Add-AzureProvisioningConfig

Modul:

Azure

Lägger till etableringskonfiguration för en virtuell Azure-dator.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

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

Cmdleten Add-AzureProvisioningConfig lägger till konfigurationsinformation för etablering i en konfiguration av en virtuell Azure-dator. Du kan använda konfigurationsobjektet för att skapa en virtuell dator.

Den här cmdleten stöder olika etableringskonfigurationer, inklusive fristående Windows-servrar, Windows-servrar som är anslutna till en Active Directory-domän och Linux-baserade servrar.

Om du vill skapa en Active Directory-domänansluten server anger du det fullständigt kvalificerade domännamnet för Active Directory-domänen och domänautentiseringsuppgifterna för en användare som har behörighet att ansluta den virtuella datorn till domänen.

Exempel

Exempel 1: Skapa en fristående virtuell dator

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

Det här kommandot skapar ett konfigurationsobjekt för virtuella datorer med hjälp av cmdleten New-AzureVMConfig . Kommandot skickar objektet till den aktuella cmdleten med hjälp av pipelineoperatorn. Den aktuella cmdleten lägger till etableringskonfiguration för en virtuell dator som kör Windows-operativsystemet. Konfigurationen innehåller administratörens användarnamn och lösenord. Kommandot skickar konfigurationen till cmdleten New-AzureVM , som skapar den virtuella datorn.

Exempel 2: Skapa en domänansluten virtuell dator

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"

Det här kommandot skapar ett konfigurationsobjekt för virtuella datorer och skickar det sedan till den aktuella cmdleten. Den aktuella cmdleten lägger till etableringskonfiguration för en virtuell dator som ska kopplas till contoso-domänen. Kommandot innehåller användarnamn och lösenord som krävs för att ansluta den virtuella datorn till domänen. Konfigurationen kräver att användaren ändrar användarlösenordet vid den första inloggningen. Kommandot skapar den virtuella datorn baserat på etableringsobjektet.

Exempel 3: Skapa en Linux-baserad virtuell dator

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

Det här kommandot skapar ett konfigurationsobjekt för virtuella datorer och skickar det sedan till den aktuella cmdleten. Den aktuella cmdleten lägger till etableringskonfiguration för en virtuell dator som kör Linux-operativsystemet. Konfigurationen innehåller rotanvändarnamnet och lösenordet. Kommandot skapar den virtuella datorn baserat på etableringsobjektet.

Exempel 4: Skapa en virtuell dator som innehåller certifikat för 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

Det första kommandot hämtar certifikat från ett certifikatarkiv och lagrar dem sedan i $certs matrisvariabel.

Det andra kommandot skapar ett konfigurationsobjekt för virtuella datorer och skickar det sedan till den aktuella cmdleten. Den aktuella cmdleten lägger till etableringskonfiguration som innehåller certifikat för WinRM. Kommandot skapar den virtuella datorn baserat på etableringsobjektet.

Exempel 5: Skapa en virtuell dator som har WinRM aktiverat via HTTP

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

Det här kommandot skapar ett konfigurationsobjekt för virtuella datorer och skickar det sedan till den aktuella cmdleten. Den aktuella cmdleten lägger till etableringskonfiguration som har WinRM aktiverat via HTTP. Kommandot skapar den virtuella datorn baserat på etableringsobjektet.

Exempel 6: Skapa en virtuell dator som har WinRM inaktiverat via HTTPS

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

Det här kommandot skapar ett konfigurationsobjekt för virtuella datorer och skickar det sedan till den aktuella cmdleten. Den aktuella cmdleten lägger till etableringskonfiguration som inaktiverar WinRM via HTTPS. Kommandot skapar den virtuella datorn baserat på etableringsobjektet.

Exempel 7: Skapa en virtuell dator utan nyckelexport

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

Det första kommandot hämtar certifikat från ett certifikatarkiv och lagrar dem sedan i $certs matrisvariabel.

Det andra kommandot skapar ett konfigurationsobjekt för virtuella datorer och skickar det sedan till den aktuella cmdleten. Den aktuella cmdleten lägger till etableringskonfiguration för en virtuell dator som innehåller certifikat och som inte exporterar privata nycklar. Kommandot skapar den virtuella datorn baserat på etableringsobjektet.

Parametrar

-AdminUsername

Anger användarnamnet för det administratörskonto som den här konfigurationen skapar på den virtuella datorn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Certificates

Anger en uppsättning certifikat som den här konfigurationen installerar på den virtuella datorn.

Typ:	CertificateSettingList
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CustomDataFile

Anger en datafil för den virtuella datorn. Den här cmdleten kodar innehållet i filen som Base64. Filen måste vara mindre än 64 kilobyte lång.

Om gästoperativsystemet är Windows-operativsystemet sparar den här konfigurationen dessa data som en binär fil med namnet %SYSTEMDRIVE%\AzureData\CustomData.bin.

Om gästoperativsystemet är Linux skickar den här konfigurationen data med hjälp av filen ovf-env.xml. Konfigurationen kopierar filen till katalogen /var/lib/waagent. Agenten lagrar även Base64-kodade data i /var/lib/waagent/CustomData.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableAutomaticUpdates

Anger att den här konfigurationen inaktiverar automatiska uppdateringar.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableGuestAgent

Anger att den här konfigurationen inaktiverar IaaS-gästagenten (infrastruktur som en tjänst).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableSSH

Anger att den här konfigurationen inaktiverar SSH.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableWinRMHttps

Anger att den här konfigurationen inaktiverar Windows Remote Management (WinRM) på HTTPS. Som standard är WinRM aktiverat via HTTPS.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Domain

Anger namnet på domänen för det konto som har behörighet att lägga till datorn i en domän.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DomainPassword

Anger lösenordet för det användarkonto som har behörighet att lägga till datorn i en domän.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DomainUserName

Anger namnet på det användarkonto som har behörighet att lägga till datorn i en domän.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EnableWinRMHttp

Anger att den här konfigurationen aktiverar WinRM via HTTP.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

• Fortsätt
• Ignorera
• Fråga
• TystKontinuera
• Stoppa
• Suspend

Typ:	ActionPreference
Alias:	infa
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InformationVariable

Anger en informationsvariabel.

Typ:	String
Alias:	iv
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-JoinDomain

Anger det fullständigt kvalificerade domännamnet (FQDN) för domänen som ska anslutas.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Linux

Anger att den här konfigurationen skapar en Linux-konfiguration.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LinuxUser

Anger användarnamnet för det administrativa Linux-konto som den här konfigurationen skapar på den virtuella datorn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MachineObjectOU

Anger det fullständigt kvalificerade namnet på organisationsenheten (OU) där konfigurationen skapar datorkontot.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoExportPrivateKey

Anger att den här konfigurationen inte laddar upp den privata nyckeln.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoRDPEndpoint

Anger att den här konfigurationen skapar en virtuell dator utan en fjärrskrivbordsslutpunkt.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoSSHEndpoint

Anger att den här konfigurationen skapar en virtuell dator utan en SSH-slutpunkt.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoSSHPassword

Anger att den här konfigurationen skapar en virtuell dator utan ett SSH-lösenord.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoWinRMEndpoint

Anger att den här konfigurationen inte lägger till en WinRM-slutpunkt för den virtuella datorn.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Password

Anger lösenordet för administratörskontot.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:	AzureSMProfile
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResetPasswordOnFirstLogon

Anger att den virtuella datorn kräver att användaren ändrar lösenordet vid den första inloggningen.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SSHKeyPairs

Anger SSH-nyckelpar.

Typ:	SSHKeyPairList
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SSHPublicKeys

Anger offentliga SSH-nycklar.

Typ:	SSHPublicKeyList
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-TimeZone

Anger tidszonen för den virtuella datorn, till exempel Pacific Standard Time eller Canada Central Standard Time.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-VM

Anger ett virtuellt datorobjekt.

Typ:	IPersistentVM
Alias:	InputObject
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Windows

Anger att den här konfigurationen skapar en fristående virtuell dator som kör Windows-operativsystemet.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WindowsDomain

Anger att den här konfigurationen skapar En Windows-server som är ansluten till en Active Directory-domän.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WinRMCertificate

Anger ett certifikat som den här konfigurationen associerar med en WinRM-slutpunkt.

Typ:	X509Certificate2
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-X509Certificates

Anger en matris med X509-certifikat som distribueras till en värdbaserad tjänst.

Typ:	X509Certificate2[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Relaterade länkar

• New-AzureVM
• New-AzureVMConfig