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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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