你当前正在访问 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 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
Aliases:infa
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定信息变量。

类型:String
Aliases:iv
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyPair

指定此 cmdlet 创建一个对象,用于将 SSH 密钥对插入到新的虚拟机配置中。

类型:SwitchParameter
Position:0
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

指定存储 SSH 公钥或密钥对的路径。

类型:String
Position:2
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicKey

指定此 cmdlet 创建一个对象,用于将 SSH 公钥插入到新的虚拟机配置中。

类型:SwitchParameter
Position:0
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False