Set-AzureVMChefExtension
將 Chef 擴充功能新增至虛擬機。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
語法
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>] Description
Set-AzureVMChefExtension Cmdlet 會將 Chef 擴充功能新增至虛擬機。
範例
範例 1：將 Chef 擴充功能新增至 Windows 虛擬機
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ClientRb "C:\\client.rb" -RunList "Apache" -Windows;此命令會將 Chef 擴充功能新增至 Windows 虛擬機。 當虛擬機出現時，它會使用 Chef 啟動，並在其上執行 Apache。
範例 2：使用啟動載入將 Chef 擴充功能新增至 Windows 虛擬機
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;此命令會將 Chef 擴充功能新增至 Windows 虛擬機。 當虛擬機啟動時，它會使用 Chef 啟動，並在其上執行 Apache。 啟動載入之後，虛擬機會參考 以 JSON 格式指定的 BootstrapOptions 。
範例 3：將 Chef 擴充功能新增至 Windows 虛擬機，並安裝 Apache 和 GIT
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -ValidationClientName "MyOrg-Validator" -RunList "apache, git" -Windows;此命令會將 Chef 擴充功能新增至 Windows 虛擬機。 當虛擬機啟動時，它會使用 Chef 啟動，並安裝 Apache 和 GIT。 如果您未提供 client.rb，則必須提供 Chef 伺服器 URL 和驗證用戶端名稱。
範例 4：將 Chef 擴充功能新增至 Linux 虛擬機
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -OrganizationName "MyOrg" -Linux;此命令會將 Chef 擴充功能新增至 Linux 虛擬機。 當虛擬機啟動時，它會使用 Chef 啟動。 如果您未提供 client.rb，則必須提供 Chef 伺服器 URL 和組織。
參數
-BootstrapOptions
以 JavaScript 物件表示法 （JSON） 格式指定啟動程式選項。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-BootstrapVersion
指定與擴充功能一起安裝的 Chef 用戶端版本。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ChefDaemonInterval
指定 chef-service 執行的頻率（以分鐘為單位）。 如果不想在 Azure VM 上安裝 chef-service，請在此欄位中將值設定為 0。
| 類型: | String |
| 別名: | ChefServiceInterval |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ChefServerUrl
指定 Chef 伺服器的 URL。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ClientRb
指定 Chef client.rb 的完整路徑。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Daemon
設定 chef-client 服務以進行自動執行。 節點平台應該是 Windows。 允許的選項：『none』、'service' 和 'task'。 none - 目前會防止 chef-client 服務設定為服務。 service - 將 chef-client 設定為在背景即服務中自動執行。 task - 將 chef-client 設定為自動在背景中執行，做為秒的工作。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為：
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
| 類型: | ActionPreference |
| 別名: | infa |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InformationVariable
指定資訊變數。
| 類型: | String |
| 別名: | iv |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JsonAttribute
要新增至 chef-client 第一次執行的 JSON 字串。 例如 -JsonAttribute '{“foo” ： “bar”}'
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Linux
指出此 Cmdlet 會建立以 Linux 為基礎的虛擬機。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OrganizationName
指定 Chef 延伸模組的組織名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunList
指定 Chef 節點執行清單。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Secret
用來加密和解密數據包專案值的加密金鑰。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SecretFile
檔案的路徑，其中包含用來加密和解密數據包專案值的加密金鑰。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ValidationClientName
指定驗證客戶端的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ValidationPem
指定 Chef 驗證程式 .pem 檔案路徑。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Version
指定 Chef 擴充功能的版本號碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VM
指定持續性虛擬機物件。
| 類型: | IPersistentVM |
| 別名: | InputObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Windows
指出此 Cmdlet 會建立 Windows 虛擬機。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |