Add-AzureProvisioningConfig

Modul:

Azure

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

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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.

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

-Certificates

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

Type:	CertificateSettingList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DisableAutomaticUpdates

Anger att den här konfigurationen inaktiverar automatiska uppdateringar.

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

-DisableGuestAgent

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

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

-DisableSSH

Anger att den här konfigurationen inaktiverar SSH.

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

-DisableWinRMHttps

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

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

-Domain

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

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

-DomainPassword

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

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

-DomainUserName

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

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

-EnableWinRMHttp

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

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

-InformationAction

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

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

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

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

-InformationVariable

Anger en informationsvariabel.

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

-JoinDomain

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

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

-Linux

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

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

-LinuxUser

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

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

-MachineObjectOU

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

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

-NoExportPrivateKey

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

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

-NoRDPEndpoint

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

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

-NoSSHEndpoint

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

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

-NoSSHPassword

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

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

-NoWinRMEndpoint

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

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

-Password

Anger lösenordet för administratörskontot.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-ResetPasswordOnFirstLogon

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

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

-SSHKeyPairs

Anger SSH-nyckelpar.

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

-SSHPublicKeys

Anger offentliga SSH-nycklar.

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

-TimeZone

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

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

-VM

Anger ett virtuellt datorobjekt.

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

-Windows

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

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

-WindowsDomain

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

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

-WinRMCertificate

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

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

-X509Certificates

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

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

Relaterade länkar

• New-AzureVM
• New-AzureVMConfig