Set-AzVMChefExtension
語法
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>]
Description
Set-AzVMChefExtension Cmdlet 會將 Chef 延伸模組新增至虛擬機器。
範例
範例 1:將 Chef 延伸模組新增至 Windows 虛擬機器
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
此命令會將 Chef 延伸模組新增至名為 WindowsVM001 的 Windows 虛擬機器。
當虛擬機器啟動時,Chef 會啟動虛擬機器以執行 Apache。
範例 2:將 Chef 擴充功能新增至 Linux 虛擬機器
Set-AzVMChefExtension -ResourceGroupName "ResourceGroup002" -VMName "LinuxVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Secret "my_secret" -Linux
此命令將 Chef 擴充功能新增至名為 LinuxVM001 的 Linux 虛擬機器。
當虛擬機器啟動時,Chef 會啟動虛擬機器以執行 Apache。
範例 3:使用啟動程序選項將 Chef 擴充功能新增至 Windows 虛擬機器
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
此命令會將 Chef 延伸模組新增至名為 WindowsVM002 的 Windows 虛擬機器。
當虛擬機器啟動時,Chef 會啟動虛擬機器以執行 Apache。
啟動後,虛擬機器會參考以 JSON 格式指定的 BootstrapOptions。
參數
-AutoUpgradeMinorVersion
Set-AzVMChefExtension Cmdlet 會將 Chef 延伸模組新增至虛擬機器。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 10 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-BootstrapOptions
在client_rb選項中指定組態設定。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-BootstrapVersion
指定啟動程序組態的版本。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ChefDaemonInterval
指定 chef-service 執行的頻率 (以分鐘為單位)。 如果您不想在 Azure VM 上安裝 chef-service,請在此欄位中將值設定為 0。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ChefService間隔 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ChefServerUrl
將 Chef 伺服器連結指定為 URL。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ClientRb
指定 Chef client.rb 的完整路徑。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Daemon
設定 chef-client 服務以進行自動執行。 節點平台應該是 Windows。
允許的選項:「無」、「服務」和「任務」。
none — 目前防止將 chef-client 服務設定為服務。
服務 - 將廚師用戶端設定為在背景自動執行為服務。
task - 將 chef-client 設定為在背景自動執行為排程工作。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 接受的值: | none, service, task |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-JsonAttribute
要新增至第一次執行 chef-client 的 JSON 字串。 例如 -JsonAttribute '{“foo” : “bar”}'
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Linux
表示此 Cmdlet 會建立 Windows 虛擬機器。
參數屬性
參數集
Linux
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Location
指定虛擬機器的位置。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 7 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定 Chef 延伸模組的名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ExtensionName |
參數集
(All)
| Position: | 8 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NoWait
在作業完成之前啟動作業並立即傳回。 為了確定操作是否已成功完成,請使用其他一些機制。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OrganizationName
指定 Chef 擴充功能的組織名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定包含虛擬機器的資源群組名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-RunList
指定 Chef 節點執行清單。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Secret
用來加密和解密資料包項目值的加密金鑰。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SecretFile
包含用來加密和解密資料袋項目值之加密金鑰的檔案路徑。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-TypeHandlerVersion
指定要用於此虛擬機器的延伸模組版本。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 處理常式版本, 版本 |
參數集
(All)
| Position: | 9 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ValidationClientName
Set-AzVMChefExtension Cmdlet 會將 Chef 延伸模組新增至虛擬機器。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ValidationPem
指定 Chef 驗證器 .pem 檔案路徑
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-VMName
指定虛擬機器的名稱。
此 Cmdlet 會新增此參數指定的虛擬機器的 Chef 延伸模組。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 資源名稱 |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Windows
表示此 Cmdlet 會建立 Windows 虛擬機器。
參數屬性
參數集
Windows
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出