Add-AzureProvisioningConfig

Modul:

Azure

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

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service 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
Accept pipeline input:	False
Accept wildcard characters:	False

-Certificates

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

Typ:	CertificateSettingList
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAutomaticUpdates

Gibt an, dass diese Konfiguration automatische Updates deaktiviert.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableGuestAgent

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableSSH

Gibt an, dass diese Konfiguration SSH deaktiviert.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableWinRMHttp

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	infa
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:	String
Aliases:	iv
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-Linux

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-NoExportPrivateKey

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRDPEndpoint

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSSHEndpoint

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSSHPassword

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWinRMEndpoint

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

Gibt das Kennwort des Administratorkontos an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHKeyPairs

Gibt SSH-Schlüsselpaare an.

Typ:	SSHKeyPairList
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHPublicKeys

Gibt öffentliche SSH-Schlüssel an.

Typ:	SSHPublicKeyList
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:	IPersistentVM
Aliases:	InputObject
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-WinRMCertificate

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

Typ:	X509Certificate2
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

Ähnliche Themen

• New-AzureVM,
• New-AzureVMConfig