Add-AzureProvisioningConfig

Referentie

Module:: Azure

Hiermee voegt u de inrichtingsconfiguratie toe voor een virtuele Azure-machine.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Met de cmdlet Add-AzureProvisioningConfig worden configuratiegegevens voor inrichting toegevoegd aan een configuratie van een virtuele Azure-machine. U kunt het configuratieobject gebruiken om een virtuele machine te maken.

Deze cmdlet ondersteunt verschillende inrichtingsconfiguraties, waaronder zelfstandige Windows-servers, Windows-servers die zijn gekoppeld aan een Active Directory-domein en op Linux gebaseerde servers.

Als u een server wilt maken die lid is van een Active Directory-domein, geeft u de volledig gekwalificeerde domeinnaam op van het Active Directory-domein en de domeinreferenties van een gebruiker die gemachtigd is om de virtuele machine aan het domein toe te voegen.

Voorbeelden

Voorbeeld 1: Een zelfstandige virtuele machine maken

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

Met deze opdracht maakt u een configuratieobject voor virtuele machines met behulp van de cmdlet New-AzureVMConfig . De opdracht geeft dat object door aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige cmdlet wordt de inrichtingsconfiguratie toegevoegd voor een virtuele machine waarop het Windows-besturingssysteem wordt uitgevoerd. De configuratie bevat de gebruikersnaam en het wachtwoord van de beheerder. Met de opdracht wordt de configuratie doorgegeven aan de cmdlet New-AzureVM , waarmee de virtuele machine wordt gemaakt.

Voorbeeld 2: Een aan een domein gekoppelde virtuele machine maken

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"

Met deze opdracht maakt u een configuratieobject voor virtuele machines en geeft u dit vervolgens door aan de huidige cmdlet. Met de huidige cmdlet wordt de inrichtingsconfiguratie toegevoegd voor een virtuele machine die wordt toegevoegd aan het contoso-domein. De opdracht bevat de gebruikersnaam en het wachtwoord die nodig zijn om de virtuele machine aan het domein toe te voegen. Voor de configuratie moet de gebruiker het gebruikerswachtwoord wijzigen bij de eerste aanmelding. Met de opdracht wordt de virtuele machine gemaakt op basis van het inrichtingsobject.

Voorbeeld 3: Een virtuele Linux-machine maken

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

Met deze opdracht maakt u een configuratieobject voor virtuele machines en geeft u dit vervolgens door aan de huidige cmdlet. Met de huidige cmdlet wordt de inrichtingsconfiguratie toegevoegd voor een virtuele machine waarop het Linux-besturingssysteem wordt uitgevoerd. De configuratie bevat de hoofdgebruikersnaam en het wachtwoord. Met de opdracht wordt de virtuele machine gemaakt op basis van het inrichtingsobject.

Voorbeeld 4: Een virtuele machine maken die certificaten voor WinRM bevat

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

Met de eerste opdracht worden certificaten opgehaald uit een certificaatarchief en vervolgens opgeslagen in de $certs matrixvariabele.

Met de tweede opdracht wordt een configuratieobject voor virtuele machines gemaakt en vervolgens doorgegeven aan de huidige cmdlet. De huidige cmdlet voegt inrichtingsconfiguratie toe die certificaten voor WinRM bevat. Met de opdracht wordt de virtuele machine gemaakt op basis van het inrichtingsobject.

Voorbeeld 5: Een virtuele machine maken waarvoor WinRM is ingeschakeld 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

Met deze opdracht maakt u een configuratieobject voor virtuele machines en geeft u dit vervolgens door aan de huidige cmdlet. Met de huidige cmdlet wordt inrichtingsconfiguratie toegevoegd waarvoor WinRM is ingeschakeld via HTTP. Met de opdracht wordt de virtuele machine gemaakt op basis van het inrichtingsobject.

Voorbeeld 6: Een virtuele machine maken waarvoor WinRM is uitgeschakeld 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

Met deze opdracht maakt u een configuratieobject voor virtuele machines en geeft u dit vervolgens door aan de huidige cmdlet. Met de huidige cmdlet wordt inrichtingsconfiguratie toegevoegd waarmee WinRM via HTTPS wordt uitgeschakeld. Met de opdracht wordt de virtuele machine gemaakt op basis van het inrichtingsobject.

Voorbeeld 7: Een virtuele machine maken zonder sleutelexport

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

Met de eerste opdracht worden certificaten opgehaald uit een certificaatarchief en vervolgens opgeslagen in de $certs matrixvariabele.

Met de tweede opdracht wordt een configuratieobject voor virtuele machines gemaakt en vervolgens doorgegeven aan de huidige cmdlet. Met de huidige cmdlet wordt de inrichtingsconfiguratie toegevoegd voor een virtuele machine die certificaten bevat en geen persoonlijke sleutels exporteert. Met de opdracht wordt de virtuele machine gemaakt op basis van het inrichtingsobject.

Parameters

-AdminUsername

Hiermee geeft u de gebruikersnaam op van het Administrator-account dat met deze configuratie op de virtuele machine wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Certificates

Hiermee geeft u een set certificaten op die door deze configuratie op de virtuele machine wordt geïnstalleerd.

Type:	CertificateSettingList
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CustomDataFile

Hiermee geeft u een gegevensbestand voor de virtuele machine. Met deze cmdlet wordt de inhoud van het bestand gecodeerd als Base64. Het bestand moet minder dan 64 kilobytes lang zijn.

Als het gastbesturingssysteem het Windows-besturingssysteem is, slaat deze configuratie deze gegevens op als een binair bestand met de naam %SYSTEMDRIVE%\AzureData\CustomData.bin.

Als het gastbesturingssysteem Linux is, geeft deze configuratie de gegevens door met behulp van het ovf-env.xml-bestand. Configuratie kopieert dat bestand naar de map /var/lib/waagent. De agent slaat ook de met Base64 gecodeerde gegevens op in /var/lib/waagent/CustomData.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableAutomaticUpdates

Geeft aan dat met deze configuratie automatische updates worden uitgeschakeld.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableGuestAgent

Hiermee wordt aangegeven dat met deze configuratie de IaaS-gastagent (Infrastructure as a Service) wordt uitgeschakeld.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableSSH

Geeft aan dat deze configuratie SSH uitschakelt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableWinRMHttps

Geeft aan dat deze configuratie Windows Remote Management (WinRM) uitschakelt op HTTPS. WinRM is standaard ingeschakeld via HTTPS.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Domain

Hiermee geeft u de naam op van het domein van het account dat gemachtigd is om de computer toe te voegen aan een domein.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DomainPassword

Hiermee geeft u het wachtwoord op van het gebruikersaccount dat gemachtigd is om de computer toe te voegen aan een domein.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DomainUserName

Hiermee geeft u de naam op van het gebruikersaccount dat gemachtigd is om de computer toe te voegen aan een domein.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-EnableWinRMHttp

Geeft aan dat deze configuratie WinRM via HTTP inschakelt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

Verdergaan
Negeren
Vragen
SilentlyContinue
Stoppen
Onderbreken

Type:	ActionPreference
Aliassen:	infa
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:	String
Aliassen:	iv
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-JoinDomain

Hiermee geeft u de FQDN (Fully Qualified Domain Name) van het domein dat moet worden gekoppeld.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Linux

Geeft aan dat deze configuratie een Linux-configuratie maakt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LinuxUser

Hiermee geeft u de gebruikersnaam op van het Linux-beheerdersaccount dat met deze configuratie op de virtuele machine wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MachineObjectOU

Hiermee geeft u de volledig gekwalificeerde naam van de organisatie-eenheid (OE) waarin de configuratie het computeraccount maakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoExportPrivateKey

Geeft aan dat deze configuratie de persoonlijke sleutel niet uploadt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoRDPEndpoint

Geeft aan dat deze configuratie een virtuele machine maakt zonder een extern bureaublad-eindpunt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoSSHEndpoint

Hiermee wordt aangegeven dat met deze configuratie een virtuele machine wordt gemaakt zonder een SSH-eindpunt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoSSHPassword

Geeft aan dat met deze configuratie een virtuele machine wordt gemaakt zonder een SSH-wachtwoord.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoWinRMEndpoint

Geeft aan dat deze configuratie geen WinRM-eindpunt toevoegt voor de virtuele machine.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Password

Hiermee geeft u het wachtwoord van het beheerdersaccount.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResetPasswordOnFirstLogon

Geeft aan dat de virtuele machine vereist dat de gebruiker het wachtwoord bij de eerste aanmelding wijzigt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SSHKeyPairs

Hiermee geeft u SSH-sleutelparen op.

Type:	SSHKeyPairList
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SSHPublicKeys

Hiermee geeft u openbare SSH-sleutels op.

Type:	SSHPublicKeyList
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TimeZone

Hiermee geeft u de tijdzone voor de virtuele machine, bijvoorbeeld Pacific Standard Time of Canada Central Standard Time.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:	IPersistentVM
Aliassen:	InputObject
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Windows

Geeft aan dat deze configuratie een zelfstandige virtuele machine maakt waarop het Windows-besturingssysteem wordt uitgevoerd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WindowsDomain

Geeft aan dat met deze configuratie Windows-server wordt gemaakt die is gekoppeld aan een Active Directory-domein.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WinRMCertificate

Hiermee geeft u een certificaat op dat deze configuratie aan een WinRM-eindpunt koppelt.

Type:	X509Certificate2
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-X509Certificates

Hiermee geeft u een matrix van X509-certificaten op die zijn geïmplementeerd in een gehoste service.

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Delen via