你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureRmVMChefExtension
将 Chef 扩展添加到虚拟机。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
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>] 说明
Set-AzureVMChefExtension cmdlet 将 Chef 扩展添加到虚拟机。
示例
示例 1：将 Chef 扩展添加到 Windows 虚拟机
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此命令将 Chef 扩展添加到名为 WindowsVM001 的 Windows 虚拟机。 虚拟机启动时，Chef 会启动虚拟机以运行 Apache。
示例 2：将 Chef 扩展添加到 Linux 虚拟机
PS C:\> Set-AzureRmVMChefExtension -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 虚拟机
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此命令将 Chef 扩展添加到名为 WindowsVM002 的 Windows 虚拟机。 虚拟机启动时，Chef 会启动虚拟机以运行 Apache。 启动后，虚拟机引用 JSON 格式指定的 BootstrapOptions。
参数
-AutoUpgradeMinorVersion
| 类型: | Boolean |
| Position: | 10 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BootstrapOptions
指定client_rb选项中的配置设置。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BootstrapVersion
指定启动配置的版本。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ChefDaemonInterval
指定 chef-service 运行的频率（以分钟为单位）。 如果不希望在 Azure VM 上安装 chef-service，请在此字段中将值设置为 0。
| 类型: | String |
| Aliases: | ChefServiceInterval |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ChefServerUrl
将 Chef 服务器链接指定为 URL。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ClientRb
指定 Chef client.rb 的完整路径。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Daemon
为无人参与的执行配置 chef-client 服务。 节点平台应为 Windows。 允许的选项：“none”、“service”和“task”。 none - 当前阻止 chef-client 服务配置为服务。 service - 将 chef-client 配置为在后台即服务中自动运行。 任务 - 将 chef-client 配置为在后台自动作为保密任务运行。
| 类型: | String |
| 接受的值: | none, service, task |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JsonAttribute
要添加到 chef-client 首次运行的 JSON 字符串。 例如 -JsonAttribute '{“foo” ： “bar”}'
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Linux
指示此 cmdlet 创建 Windows 虚拟机。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
指定虚拟机的位置。
| 类型: | String |
| Position: | 7 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定 Chef 扩展的名称。
| 类型: | String |
| Aliases: | ExtensionName |
| Position: | 8 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OrganizationName
指定 Chef 扩展的组织名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
指定包含虚拟机的资源组的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RunList
指定 Chef 节点运行列表。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Secret
用于加密和解密数据包项值的加密密钥。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SecretFile
包含用于加密和解密数据包项值的加密密钥的文件的路径。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TypeHandlerVersion
指定要用于此虚拟机的扩展版本。
| 类型: | String |
| Aliases: | HandlerVersion, Version |
| Position: | 9 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ValidationClientName
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ValidationPem
指定 Chef 验证程序 .pem 文件路径
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
指定虚拟机的名称。 此 cmdlet 为此参数指定的虚拟机添加 Chef 扩展。
| 类型: | String |
| Aliases: | ResourceName |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
| 类型: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Windows
指示此 cmdlet 创建 Windows 虚拟机。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |