你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Import-AzKeyVaultCertificate

模块:: Az.KeyVault Module

将证书导入密钥保管库。

语法

ImportCertificateFromFile (默认值)

Import-AzKeyVaultCertificate
    [-VaultName] <String>
    [-Name] <String>
    -FilePath <String>
    [-Password <SecureString>]
    [-PolicyPath <String>]
    [-PolicyObject <PSKeyVaultCertificatePolicy>]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ImportWithPrivateKeyFromString

Import-AzKeyVaultCertificate
    [-VaultName] <String>
    [-Name] <String>
    -CertificateString <String>
    [-ContentType <String>]
    [-Password <SecureString>]
    [-PolicyPath <String>]
    [-PolicyObject <PSKeyVaultCertificatePolicy>]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ImportWithPrivateKeyFromCollection

Import-AzKeyVaultCertificate
    [-VaultName] <String>
    [-Name] <String>
    [-CertificateCollection] <X509Certificate2Collection>
    [-PolicyPath <String>]
    [-PolicyObject <PSKeyVaultCertificatePolicy>]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Import-AzKeyVaultCertificate cmdlet 将证书导入密钥保管库。可以使用以下方法之一创建要导入的证书：

用于 Add-AzKeyVaultCertificate 创建证书签名请求并将其提交到证书颁发机构。请参见https://dori-uw-1.kuma-moon.com/azure/key-vault/certificates/create-certificate-signing-request
使用包含证书和私钥的现有证书包文件，例如 .pfx 或 .p12 文件。

示例

示例 1：导入密钥保管库证书

$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -FilePath "C:\Users\contosoUser\Desktop\import.pfx" -Password $Password

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:50:43 PM
Updated     : 2/8/2016 11:50:43 PM

第一个命令使用 ConvertTo-SecureString cmdlet 创建安全密码，然后将其存储在$Password变量中。第二个命令将名为 ImportCert01 的证书导入 ContosoKV01 密钥保管库。

示例 2：通过 CertificateString 导入密钥保管库证书

$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$Base64String = [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("import.pfx"))
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -CertificateString $Base64String -Password $Password

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:50:43 PM
Updated     : 2/8/2016 11:50:43 PM

第一个命令使用 ConvertTo-SecureString cmdlet 创建安全密码，然后将其存储在$Password变量中。第二个命令将证书读取为 Base64 编码表示形式。第三个命令将名为 ImportCert01 的证书导入 ContosoKV01 密钥保管库。

示例 3：使用 PolicyFile 导入密钥保管库证书

$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -FilePath "C:\Users\contosoUser\Desktop\import.pfx" -Password $Password -PolicyPath "C:\Users\contosoUser\Desktop\policy.json"

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

KeyId         : https://ContosoKV01.vault.azure.net/keys/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
SecretId      : https://ContosoKV01.vault.azure.net/secrets/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Thumbprint    : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Policy        :
                Secret Content Type: application/x-pkcs12
                Issuer Name    : Unknown
                Created On     : 3/22/2023 6:00:52 AM
                Updated On     : 4/27/2023 9:52:53 AM
                ...
RecoveryLevel : Recoverable+Purgeable
Enabled       : True
Expires       : 6/9/2023 6:20:26 AM
NotBefore     : 3/11/2023 6:20:26 AM
Created       : 4/24/2023 9:05:51 AM
Updated       : 4/24/2023 9:05:51 AM
Tags          : {}
VaultName     : ContosoKV01
Name          : ImportCert01
Version       : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Id            : https://ContosoKV01.vault.azure.net/certificates/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

第一个命令使用 ConvertTo-SecureString cmdlet 创建安全密码，然后将其存储在$Password变量中。第二个命令使用文件定义的策略将名为 ImportCert01 的证书导入 ContosoKV01 密钥保管库。

参数

-CertificateCollection

指定要添加到密钥保管库的证书集合。

参数属性

类型:	X509Certificate2Collection
默认值:	None
支持通配符:	False
不显示:	False

参数集

ImportWithPrivateKeyFromCollection

Position:	2
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CertificateString

要导入的证书对象的 Base64 编码表示形式。此证书需要包含私钥。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ImportWithPrivateKeyFromString

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	Cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ContentType

指定要导入的证书的类型。默认情况下，将证书字符串视为 PFX 格式。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ImportWithPrivateKeyFromString

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-FilePath

指定此 cmdlet 导入的证书文件的路径。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ImportCertificateFromFile

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

指定证书名称。此 cmdlet 从密钥保管库名称、当前选定的环境和证书名称构造证书的完全限定域名（FQDN）。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	CertificateName

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Password

指定证书文件的密码。

参数属性

类型:	SecureString
默认值:	None
支持通配符:	False
不显示:	False

参数集

ImportCertificateFromFile

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

ImportWithPrivateKeyFromString

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PolicyObject

用于指定证书管理策略的内存中对象。与 PolicyPath 互斥。

参数属性

类型:	PSKeyVaultCertificatePolicy
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PolicyPath

一个文件路径，用于为包含 JSON 编码策略定义的证书指定管理策略。与 PolicyObject 互斥。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Tag

以哈希表的形式进行键值对。例如：@{key0=“value0”;key1=$null;key2=“value2”}

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-VaultName

指定此 cmdlet 将证书导入到的密钥保管库名称。此 cmdlet 基于名称和当前所选环境构造密钥保管库的完全限定域名（FQDN）。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

输出

PSKeyVaultCertificate

反馈

此页面是否有帮助？

通过

Import-AzKeyVaultCertificate

语法

ImportCertificateFromFile (默认值)

ImportWithPrivateKeyFromString

ImportWithPrivateKeyFromCollection

说明

示例

示例 1：导入密钥保管库证书

示例 2：通过 CertificateString 导入密钥保管库证书

示例 3：使用 PolicyFile 导入密钥保管库证书

参数

-CertificateCollection

参数属性

参数集

-CertificateString

参数属性

参数集

-Confirm

参数属性

参数集

-ContentType

参数属性

参数集

-DefaultProfile

参数属性

参数集

-FilePath

参数属性

参数集

-Name

参数属性

参数集

-Password

参数属性

参数集

-PolicyObject

参数属性

参数集

-PolicyPath

参数属性

参数集

-Tag

参数属性

参数集

-VaultName

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

String

X509Certificate2Collection

Hashtable

输出

PSKeyVaultCertificate

相关链接

反馈