Freigeben über

Add-AzureProvisioningConfig

  • Referenz
Modul:
Azure

Fügt die Bereitstellungskonfiguration für einen virtuellen Azure-Computer hinzu.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

Beschreibung

Das Add-AzureProvisioningConfig-Cmdlet fügt Bereitstellungskonfigurationsinformationen zu einer Konfiguration eines virtuellen Azure-Computers hinzu. Sie können das Konfigurationsobjekt verwenden, um einen virtuellen Computer zu erstellen.

Dieses Cmdlet unterstützt verschiedene Bereitstellungskonfigurationen, einschließlich eigenständiger Windows-Server, Windows-Server, die mit einer Active Directory-Domäne verbunden sind, und Linux-basierte Server.

Geben Sie zum Erstellen eines in Active Directory eingebundenen Servers den vollqualifizierten Domänennamen der Active Directory-Domäne und die Domänenanmeldeinformationen eines Benutzers an, der über die Berechtigung zum Beitritt zum virtuellen Computer zur Domäne verfügt.

Beispiele

Beispiel 1: Erstellen eines eigenständigen virtuellen Computers

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

Mit diesem Befehl wird ein Konfigurationsobjekt für virtuelle Computer mithilfe des Cmdlets New-AzureVMConfig erstellt. Der Befehl übergibt dieses Objekt mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration für einen virtuellen Computer hinzu, auf dem das Windows-Betriebssystem ausgeführt wird. Die Konfiguration umfasst den Administratorbenutzernamen und das Kennwort. Der Befehl übergibt die Konfiguration an das New-AzureVM-Cmdlet , das den virtuellen Computer erstellt.

Beispiel 2: Erstellen eines in eine Domäne eingebundenen virtuellen Computers

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"

Dieser Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt es dann an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration für einen virtuellen Computer hinzu, der mit der Contoso-Domäne verknüpft werden soll. Der Befehl enthält Benutzernamen und Kennwort, die erforderlich sind, um den virtuellen Computer mit der Domäne zu verbinden. Für die Konfiguration muss der Benutzer das Benutzerkennwort bei der ersten Anmeldung ändern. Der Befehl erstellt den virtuellen Computer basierend auf dem Bereitstellungsobjekt.

Beispiel 3: Erstellen eines linuxbasierten virtuellen Computers

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

Dieser Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt es dann an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration für einen virtuellen Computer hinzu, auf dem das Linux-Betriebssystem ausgeführt wird. Die Konfiguration enthält den Stammbenutzernamen und das Kennwort. Der Befehl erstellt den virtuellen Computer basierend auf dem Bereitstellungsobjekt.

Beispiel 4: Erstellen eines virtuellen Computers mit Zertifikaten 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

Der erste Befehl ruft Zertifikate aus einem Zertifikatspeicher ab und speichert sie dann in der $certs Arrayvariable.

Der zweite Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt es dann an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration hinzu, die Zertifikate für WinRM enthält. Der Befehl erstellt den virtuellen Computer basierend auf dem Bereitstellungsobjekt.

Beispiel 5: Erstellen eines virtuellen Computers, auf dem WinRM über HTTP aktiviert ist

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

Dieser Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt es dann an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration hinzu, für die WinRM über HTTP aktiviert ist. Der Befehl erstellt den virtuellen Computer basierend auf dem Bereitstellungsobjekt.

Beispiel 6: Erstellen eines virtuellen Computers, auf dem WinRM über HTTPS deaktiviert ist

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

Dieser Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt es dann an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration hinzu, die WinRM über HTTPS deaktiviert. Der Befehl erstellt den virtuellen Computer basierend auf dem Bereitstellungsobjekt.

Beispiel 7: Erstellen eines virtuellen Computers ohne Schlüsselexport

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

Der erste Befehl ruft Zertifikate aus einem Zertifikatspeicher ab und speichert sie dann in der $certs Arrayvariable.

Der zweite Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt es dann an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Bereitstellungskonfiguration für einen virtuellen Computer hinzu, der Zertifikate enthält und keine privaten Schlüssel exportiert. Der Befehl erstellt den virtuellen Computer basierend auf dem Bereitstellungsobjekt.

Parameter

-AdminUsername

Gibt den Benutzernamen des Administratorkontos an, das diese Konfiguration auf dem virtuellen Computer erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Certificates

Gibt einen Satz von Zertifikaten an, die diese Konfiguration auf dem virtuellen Computer installiert.

Typ:CertificateSettingList
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomDataFile

Gibt eine Datendatei für den virtuellen Computer an. Dieses Cmdlet codiert den Inhalt der Datei als Base64. Die Datei muss kleiner als 64 KB sein.

Wenn das Gastbetriebssystem das Windows-Betriebssystem ist, speichert diese Konfiguration diese Daten als Binärdatei mit dem Namen %SYSTEMDRIVE%\AzureData\CustomData.bin.

Wenn das Gastbetriebssystem Linux ist, übergibt diese Konfiguration die Daten mithilfe der ovf-env.xml Datei. Die Konfiguration kopiert diese Datei in das Verzeichnis "/var/lib/waagent". Der Agent speichert auch die base64-codierten Daten in /var/lib/waagent/CustomData.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableAutomaticUpdates

Gibt an, dass diese Konfiguration automatische Updates deaktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableGuestAgent

Gibt an, dass diese Konfiguration die Infrastruktur als IaaS-Gast-Agent deaktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableSSH

Gibt an, dass diese Konfiguration SSH deaktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWinRMHttps

Gibt an, dass diese Konfiguration die Windows-Remoteverwaltung (WinRM) unter HTTPS deaktiviert. Standardmäßig ist WinRM über HTTPS aktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Domain

Gibt den Namen der Domäne des Kontos an, das über die Berechtigung zum Hinzufügen des Computers zu einer Domäne verfügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainPassword

Gibt das Kennwort des Benutzerkontos an, das über die Berechtigung zum Hinzufügen des Computers zu einer Domäne verfügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainUserName

Gibt den Namen des Benutzerkontos an, das über die Berechtigung zum Hinzufügen des Computers zu einer Domäne verfügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableWinRMHttp

Gibt an, dass diese Konfiguration WinRM über HTTP aktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JoinDomain

Gibt den vollqualifizierten Domänennamen (FQDN) der Domäne an, der hinzugefügt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Linux

Gibt an, dass diese Konfiguration eine Linux-Konfiguration erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LinuxUser

Gibt den Benutzernamen des Linux-Verwaltungskontos an, das diese Konfiguration auf dem virtuellen Computer erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MachineObjectOU

Gibt den vollqualifizierten Namen der Organisationseinheit (OU) an, in der die Konfiguration das Computerkonto erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoExportPrivateKey

Gibt an, dass diese Konfiguration den privaten Schlüssel nicht hochlädt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoRDPEndpoint

Gibt an, dass diese Konfiguration einen virtuellen Computer ohne Remotedesktopendpunkt erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoSSHEndpoint

Gibt an, dass diese Konfiguration einen virtuellen Computer ohne SSH-Endpunkt erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoSSHPassword

Gibt an, dass diese Konfiguration einen virtuellen Computer ohne SSH-Kennwort erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWinRMEndpoint

Gibt an, dass diese Konfiguration keinen WinRM-Endpunkt für den virtuellen Computer hinzugibt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Password

Gibt das Kennwort des Administratorkontos an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResetPasswordOnFirstLogon

Gibt an, dass der virtuelle Computer erfordert, dass der Benutzer das Kennwort bei der ersten Anmeldung ändern muss.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SSHKeyPairs

Gibt SSH-Schlüsselpaare an.

Typ:SSHKeyPairList
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SSHPublicKeys

Gibt öffentliche SSH-Schlüssel an.

Typ:SSHPublicKeyList
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeZone

Gibt die Zeitzone für den virtuellen Computer an, z. B. Pacific Standard Time oder Canada Central Standard Time.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Windows

Gibt an, dass diese Konfiguration einen eigenständigen virtuellen Computer erstellt, auf dem das Windows-Betriebssystem ausgeführt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WindowsDomain

Gibt an, dass diese Konfiguration Einen Windows-Server erstellt, der einer Active Directory-Domäne beigetreten ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WinRMCertificate

Gibt ein Zertifikat an, das diese Konfiguration einem WinRM-Endpunkt zuordnet.

Typ:X509Certificate2
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-X509Certificates

Gibt ein Array von X509-Zertifikaten an, die für einen gehosteten Dienst bereitgestellt werden.

Typ:X509Certificate2[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False