Freigeben über

Set-AzureRmVMChefExtension

  • Referenz
Modul:
AzureRM.Compute

Fügt eine Cheferweiterung zu einem virtuellen Computer hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureRmVMChefExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-TypeHandlerVersion] <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-RunList <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Linux]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVMChefExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-TypeHandlerVersion] <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-RunList <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Windows]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<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-AzureRmVMChefExtension -ResourceGroupName "ResourceGroup001" -VMName "WindowsVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Daemon "service" -SecretFile "C:\my_encrypted_data_bag_secret" -Windows

Mit diesem Befehl wird eine Chef-Erweiterung zu einem virtuellen Windows-Computer namens "WindowsVM001" hinzugefügt. Wenn der virtuelle Computer gestartet wird, startet Chef den virtuellen Computer, um Apache auszuführen.

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

PS C:\> Set-AzureRmVMChefExtension -ResourceGroupName "ResourceGroup002" -VMName "LinuxVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Secret "my_secret" -Linux

Mit diesem Befehl wird eine Chef-Erweiterung zu einem virtuellen Linux-Computer namens "LinuxVM001" hinzugefügt. Wenn der virtuelle Computer gestartet wird, startet Chef den virtuellen Computer, um Apache auszuführen.

Beispiel 3: Hinzufügen einer Cheferweiterung zu einem virtuellen Windows-Computer mit Bootstrapoptionen

PS C:\> Set-AzureRmVMChefExtension -ResourceGroupName "ResourceGroup003" -VMName "WindowsVM002" -ValidationPem C:\my-org-validator.pem -ClientRb C:\client.rb -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 namens "WindowsVM002" hinzugefügt. Wenn der virtuelle Computer gestartet wird, startet Chef den virtuellen Computer, um Apache auszuführen. Nach dem Bootstrapping bezieht sich der virtuelle Computer auf die im JSON-Format angegebenen BootstrapOptions.

Parameter

-AutoUpgradeMinorVersion

Typ:Boolean
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-BootstrapOptions

Gibt Konfigurationseinstellungen in der Option client_rb an.

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

-BootstrapVersion

Gibt die Version der Bootstrap-Konfiguration an.

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 den Chefserverlink als URL 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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
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
Zulässige Werte:none, service, task
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
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 virtuellen Windows-Computer erstellt.

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

-Location

Gibt den Speicherort des virtuellen Computers an.

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

-Name

Gibt den Namen der Cheferweiterung an.

Typ:String
Aliase:ExtensionName
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OrganizationName

Gibt den Organisationsnamen der Cheferweiterung an.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die den virtuellen Computer enthält.

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

-TypeHandlerVersion

Gibt die Version der Erweiterung an, die für diesen virtuellen Computer verwendet werden soll.

Typ:String
Aliase:HandlerVersion, Version
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ValidationClientName

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

-VMName

Gibt den Namen eines virtuellen Computers an. Dieses Cmdlet fügt die Chef-Erweiterung für den virtuellen Computer hinzu, den dieser Parameter angibt.

Typ:String
Aliase:ResourceName
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
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

Eingaben

String

Boolean

Ausgaben

PSAzureOperationResponse