你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureSSHKey
创建 SSH 密钥对象，将现有证书插入到基于 Linux 的新 Azure 虚拟机中。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
New-AzureSSHKey
[-KeyPair]
[-Fingerprint] <String>
[-Path] <String>
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] New-AzureSSHKey
[-PublicKey]
[-Fingerprint] <String>
[-Path] <String>
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 说明
New-AzureSSHKey cmdlet 为已添加到 Azure 的证书创建 SSH 密钥对象。 然后，使用 New-AzureVM 为新虚拟机创建配置对象或使用 New-AzureQuickVM 创建新虚拟机时，New-AzureProvisioningConfig 可以使用此 SSH 密钥对象。 当作为虚拟机创建脚本的一部分包含时，这会向新虚拟机添加指定的 SSH 公钥或密钥对。
示例
示例 1：创建证书设置对象
PS C:\> $myLxCert = New-AzureSSHKey -Fingerprint "D7BECD4D63EBAF86023BB4F1A5FBF5C2C924902A" -Path "/home/username/.ssh/authorized_keys"此命令为现有证书创建证书设置对象，然后将该对象存储在变量中供以后使用。
示例 2：向服务添加证书
PS C:\> Add-AzureCertificate -ServiceName "MySvc" -CertToDeploy "C:\temp\MyLxCert.cer"
$myLxCert = New-AzureSSHKey ?Fingerprint "D7BECD4D63EBAF86023BB4F1A5FBF5C2C924902A" -Path "/home/username/.ssh/authorized_keys"
New-AzureVMConfig -Name "MyVM2" -InstanceSize Small -ImageName $LxImage `
| Add-AzureProvisioningConfig -Linux -LinuxUser $lxUser -SSHPublicKeys $myLxCert -Password 'pass@word1' `
| New-AzureVM -ServiceName "MySvc"此命令将证书添加到 Azure 服务，然后创建使用证书的新 Linux 虚拟机。
参数
-Fingerprint
指定证书的指纹。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为：
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
| 类型: | ActionPreference |
| 别名: | infa |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InformationVariable
指定信息变量。
| 类型: | String |
| 别名: | iv |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-KeyPair
指定此 cmdlet 创建一个对象，用于将 SSH 密钥对插入到新的虚拟机配置中。
| 类型: | SwitchParameter |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Path
指定存储 SSH 公钥或密钥对的路径。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublicKey
指定此 cmdlet 创建一个对象，用于将 SSH 公钥插入到新的虚拟机配置中。
| 类型: | SwitchParameter |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |