Set-AzVMChefExtension
Fügt eine Cheferweiterung zu einem virtuellen Computer hinzu.
Syntax
Linux
Set-AzVMChefExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[[-TypeHandlerVersion] <String>]
[[-Location] <String>]
[[-Name] <String>]
[[-AutoUpgradeMinorVersion] <Boolean>]
-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]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Windows
Set-AzVMChefExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[[-TypeHandlerVersion] <String>]
[[-Location] <String>]
[[-Name] <String>]
[[-AutoUpgradeMinorVersion] <Boolean>]
-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]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Set-AzVMChefExtension wird der virtuellen Maschine die Chef-Erweiterung hinzugefügt.
Beispiele
Beispiel 1: Hinzufügen einer Cheferweiterung zu einem virtuellen Windows-Computer
Set-AzVMChefExtension -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
Set-AzVMChefExtension -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
Set-AzVMChefExtension -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
Mit dem Cmdlet Set-AzVMChefExtension wird der virtuellen Maschine die Chef-Erweiterung hinzugefügt.
Parametereigenschaften
Typ: Boolean
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: 10 Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-BootstrapOptions
Gibt Konfigurationseinstellungen in der Option client_rb an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-BootstrapVersion
Gibt die Version der Bootstrap-Konfiguration an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: ChefServiceInterval
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ChefServerUrl
Gibt den Chefserverlink als URL an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ClientRb
Gibt den vollständigen Pfad des Chefclients.rb an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: vgl
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Zulässige Werte: none, service, task Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-JsonAttribute
Eine JSON-Zeichenfolge, die der ersten Ausführung des Chefclients hinzugefügt werden soll. z. B. -JsonAttribute '{"foo" : "bar"}'
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-Linux
Gibt an, dass dieses Cmdlet einen virtuellen Windows-Computer erstellt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
Linux
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Location
Gibt den Speicherort des virtuellen Computers an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: 7 Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-Name
Gibt den Namen der Cheferweiterung an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: ExtensionName
Parametersätze
(All)
Position: 8 Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-NoWait
Startet den Vorgang und gibt sofort zurück, bevor der Vorgang abgeschlossen ist. Um festzustellen, ob der Vorgang erfolgreich abgeschlossen wurde, verwenden Sie einen anderen Mechanismus.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-OrganizationName
Gibt den Organisationsnamen der Cheferweiterung an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Gibt den Namen der Ressourcengruppe an, die den virtuellen Computer enthält.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: 0 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-RunList
Gibt die Chef-Knoten-Ausführungsliste an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-Secret
Der Verschlüsselungsschlüssel, der zum Verschlüsseln und Entschlüsseln der Datenbehälterelementwerte verwendet wird.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-TypeHandlerVersion
Gibt die Version der Erweiterung an, die für diesen virtuellen Computer verwendet werden soll.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: HandlerVersion, Version
Parametersätze
(All)
Position: 9 Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ValidationClientName
Mit dem Cmdlet Set-AzVMChefExtension wird der virtuellen Maschine die Chef-Erweiterung hinzugefügt.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ValidationPem
Gibt den Dateipfad "Chef validator.pem" an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Ressourcenname
Parametersätze
(All)
Position: 1 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird.
Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Wi
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Windows
Gibt an, dass dieses Cmdlet einen virtuellen Windows-Computer erstellt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
Windows
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben
