Freigeben über

Set-AzureVMChefExtension

  • Referenz
Modul:
Azure

Fügt die Chef-Erweiterung dem virtuellen 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

Set-AzureVMChefExtension
   [-Version <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-RunList <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-Windows]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMChefExtension
   [-Version <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-RunList <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-Linux]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureVMChefExtension fügt der virtuellen Maschine die Chef-Erweiterung hinzu.

Beispiele

Beispiel 1: Hinzufügen einer Cheferweiterung zu einem virtuellen Windows-Computer

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ClientRb "C:\\client.rb" -RunList "Apache" -Windows;

Mit diesem Befehl wird eine Chef-Erweiterung zu einem virtuellen Windows-Computer hinzugefügt. Wenn der virtuelle Computer kommt, wird er mit Chef bootstrappt und Apache darauf ausgeführt.

Beispiel 2: Hinzufügen einer Cheferweiterung zu einem virtuellen Windows-Computer mit Bootstrapping

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -BootstrapOptions '{"chef_node_name":"your_node_name","chef_server_url":"https://api.opscode.com/organizations/some-org", "validation_client_name":"some-org-validator"}' -RunList "Apache" -Windows;

Mit diesem Befehl wird die Chef-Erweiterung zu einem virtuellen Windows-Computer hinzugefügt. Wenn der virtuelle Computer gestartet wird, wird er mit Chef gestartet und führt Apache darauf aus. Nach dem Bootstrapping bezieht sich der virtuelle Computer auf die im JSON-Format angegebenen BootstrapOptions .

Beispiel 3: Hinzufügen einer Cheferweiterung zu einem virtuellen Windows-Computer und Installieren von Apache und GIT

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -ValidationClientName "MyOrg-Validator" -RunList "apache, git" -Windows;

Mit diesem Befehl wird die Chef-Erweiterung zu einem virtuellen Windows-Computer hinzugefügt. Wenn der virtuelle Computer gestartet wird, wird er mit Chef gestartet und Apache und GIT installiert. Wenn Sie den Client.rb nicht angeben, müssen Sie die Chef-Server-URL und den Namen des Validierungsclients angeben.

Beispiel 4: Hinzufügen einer Cheferweiterung zu einem virtuellen Linux-Computer

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -OrganizationName "MyOrg" -Linux;

Mit diesem Befehl wird die Chef-Erweiterung zu einem virtuellen Linux-Computer hinzugefügt. Wenn der virtuelle Computer gestartet wird, wird er mit Chef gestartet. Wenn Sie den Client.rb nicht angeben, müssen Sie die Chef-Server-URL und -Organisation angeben.

Parameter

-BootstrapOptions

Gibt Bootstrapoptionen im Json-Format (JavaScript Object Notation) an.

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

-BootstrapVersion

Gibt die Version des Chef-Clients an, die zusammen mit der Erweiterung installiert wird.

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

-ChefDaemonInterval

Gibt die Häufigkeit (in Minuten) an, mit der der Chefdienst ausgeführt wird. Wenn Sie nicht möchten, dass der Chefdienst auf der Azure-VM installiert wird, legen Sie den Wert in diesem Feld auf 0 fest.

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

-ChefServerUrl

Gibt die URL des Chefservers an.

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

-ClientRb

Gibt den vollständigen Pfad des Chefclients.rb an.

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

-Daemon

Konfiguriert den Chefclientdienst für die unbeaufsichtigte Ausführung. Die Knotenplattform sollte Windows sein. Zulässige Optionen: 'none','service' und 'task'. none – Zurzeit wird verhindert, dass der Chefclientdienst als Dienst konfiguriert wird. service – Konfiguriert den Chefclient so, dass er automatisch im Hintergrund als Dienst ausgeführt wird. task – Konfiguriert den Chefclient so, dass er automatisch im Hintergrund als geplante Aufgabe ausgeführt wird.

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • 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

-JsonAttribute

Eine JSON-Zeichenfolge, die der ersten Ausführung des Chefclients hinzugefügt werden soll. z. B. -JsonAttribute '{"foo" : "bar"}'

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

-Linux

Gibt an, dass dieses Cmdlet einen linuxbasierten virtuellen Computer erstellt.

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

-OrganizationName

Gibt den Organisationsnamen der Cheferweiterung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-RunList

Gibt die Chef-Knoten-Ausführungsliste an.

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

-Secret

Der Verschlüsselungsschlüssel, der zum Verschlüsseln und Entschlüsseln der Datenbehälterelementwerte verwendet wird.

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

-SecretFile

Der Pfad zu der Datei, die den Verschlüsselungsschlüssel enthält, der zum Verschlüsseln und Entschlüsseln der Datenbehälterelementwerte verwendet wird.

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

-ValidationClientName

Gibt den Namen des Überprüfungsclients an.

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

-ValidationPem

Gibt den Dateipfad "Chef validator.pem" an.

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

-Version

Gibt die Versionsnummer der Cheferweiterung an.

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

-VM

Gibt das objekt des beständigen virtuellen Computers an.

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

-Windows

Gibt an, dass dieses Cmdlet einen virtuellen Windows-Computer erstellt.

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