Get-AzKeyVaultCertificate

Модуль:: Az.KeyVault Module

Возвращает сертификат из хранилища ключей.

Синтаксис

ByName (по умолчанию)

Get-AzKeyVaultCertificate
    [-VaultName] <String>
    [[-Name] <String>]
    [-InRemovedState]
    [-IncludePending]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByCertificateNameAndVersion

Get-AzKeyVaultCertificate
    [-VaultName] <String>
    [-Name] <String>
    [-Version] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByCertificateAllVersions

Get-AzKeyVaultCertificate
    [-VaultName] <String>
    [-Name] <String>
    [-IncludeVersions]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByNameInputObject

Get-AzKeyVaultCertificate
    [-InputObject] <PSKeyVault>
    [[-Name] <String>]
    [-InRemovedState]
    [-IncludePending]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByCertificateNameAndVersionInputObject

Get-AzKeyVaultCertificate
    [-InputObject] <PSKeyVault>
    [-Name] <String>
    [-Version] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByCertificateAllVersionsInputObject

Get-AzKeyVaultCertificate
    [-InputObject] <PSKeyVault>
    [-Name] <String>
    [-IncludeVersions]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByNameResourceId

Get-AzKeyVaultCertificate
    [-ResourceId] <String>
    [[-Name] <String>]
    [-InRemovedState]
    [-IncludePending]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByCertificateNameAndVersionResourceId

Get-AzKeyVaultCertificate
    [-ResourceId] <String>
    [-Name] <String>
    [-Version] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByCertificateAllVersionsResourceId

Get-AzKeyVaultCertificate
    [-ResourceId] <String>
    [-Name] <String>
    [-IncludeVersions]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет Get-AzKeyVaultCertificate получает указанный сертификат или версии сертификата из хранилища ключей в Azure Key Vault.

Примеры

Пример 1. Получение сертификата

Get-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "TestCert01"

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

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

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

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

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

KeyId       : https://contoso.vault.azure.net:443/keys/TestCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
SecretId    : https://contoso.vault.azure.net:443/secrets/TestCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:21:45 PM
Updated     : 2/8/2016 11:21:45 PM

Эта команда получает сертификат с именем TestCert01 из хранилища ключей с именем ContosoKV01

Пример 2. Получение сертификата и сохранение его в виде PFX

$CertBase64 = Get-AzKeyVaultSecret -VaultName $vaultName -Name $certName -AsPlainText
$CertBytes = [Convert]::FromBase64String($CertBase64)
Set-Content -Path cert.pfx -Value $CertBytes -AsByteStream

Эта команда получает сертификат с именем $certName из хранилища ключей с именем $vaultName. Эти команды получают доступ к секрету $certName , а затем сохраняют содержимое в виде PFX-файла.

Пример 3. Получение всех сертификатов, которые были удалены, но не удалены для этого хранилища ключей.

Get-AzKeyVaultCertificate -VaultName 'contoso' -InRemovedState

DeletedDate        : 5/24/2018 6:08:32 PM
Enabled            : True
Expires            : 11/24/2018 6:08:13 PM
NotBefore          : 5/24/2018 5:58:13 PM
Created            : 5/24/2018 6:08:13 PM
Updated            : 5/24/2018 6:08:13 PM
Tags               :
VaultName          : contoso
Name               : test1
Version            :
Id                 : https://contoso.vault.azure.net:443/certificates/test1

ScheduledPurgeDate : 8/22/2018 6:10:47 PM
DeletedDate        : 5/24/2018 6:10:47 PM
Enabled            : True
Expires            : 11/24/2018 6:09:44 PM
NotBefore          : 5/24/2018 5:59:44 PM
Created            : 5/24/2018 6:09:44 PM
Updated            : 5/24/2018 6:09:44 PM
Tags               :
VaultName          : contoso
Name               : test2
Version            :
Id                 : https://contoso.vault.azure.net:443/certificates/test2

Эта команда получает все сертификаты, которые ранее были удалены, но не очищались, в хранилище ключей с именем Contoso.

Пример 4. Возвращает сертификат MyCert, который был удален, но не удален для этого хранилища ключей.

Get-AzKeyVaultCertificate -VaultName 'contoso' -Name 'test1' -InRemovedState

Certificate        : [Subject]
                       CN=contoso.com

                     [Issuer]
                       CN=contoso.com

                     [Serial Number]
                       XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

                     [Not Before]
                       5/24/2018 10:58:13 AM

                     [Not After]
                       11/24/2018 10:08:13 AM

                     [Thumbprint]
                       XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

KeyId              : https://contoso.vault.azure.net:443/keys/test1/7fe415d5518240c1a6fce89986b8d334
SecretId           : https://contoso.vault.azure.net:443/secrets/test1/7fe415d5518240c1a6fce89986b8d334
Thumbprint         : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
RecoveryLevel      : Recoverable+Purgeable
ScheduledPurgeDate : 8/22/2018 6:08:32 PM
DeletedDate        : 5/24/2018 6:08:32 PM
Enabled            : True
Expires            : 11/24/2018 6:08:13 PM
NotBefore          : 5/24/2018 5:58:13 PM
Created            : 5/24/2018 6:08:13 PM
Updated            : 5/24/2018 6:08:13 PM
Tags               :
VaultName          : contoso
Name               : test1
Version            : 7fe415d5518240c1a6fce89986b8d334
Id                 : https://contoso.vault.azure.net:443/certificates/test1/7fe415d5518240c1a6fce89986b8d334

Эта команда получает сертификат с именем MyCert, который был удален ранее, но не очищался, в хранилище ключей с именем Contoso. Эта команда вернет метаданные, такие как дата удаления, и запланированная дата очистки этого удаленного сертификата.

Пример 5. Вывод списка сертификатов с помощью фильтрации

Get-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "test*"

Enabled   : True
Expires   : 8/5/2019 2:39:25 AM
NotBefore : 2/5/2019 2:29:25 AM
Created   : 2/5/2019 2:39:25 AM
Updated   : 2/5/2019 2:39:25 AM
Tags      :
VaultName : ContosoKV01
Name      : test1
Version   :
Id        : https://ContosoKV01.vault.azure.net:443/certificates/test1

Enabled   : True
Expires   : 8/5/2019 2:39:25 AM
NotBefore : 2/5/2019 2:29:25 AM
Created   : 2/5/2019 2:39:25 AM
Updated   : 2/5/2019 2:39:25 AM
Tags      :
VaultName : ContosoKV01
Name      : test2
Version   :
Id        : https://ContosoKV01.vault.azure.net:443/certificates/test2

Эта команда получает все сертификаты, начиная с "test" из хранилища ключей с именем ContosoKV01.

Параметры

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметра

Тип:	IAzureContextContainer
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-IncludePending

Указывает, следует ли включать ожидающие сертификаты в выходные данные.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByNameInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByNameResourceId

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-IncludeVersions

Указывает, что эта операция получает все версии сертификата.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByCertificateAllVersions

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateAllVersionsInputObject

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateAllVersionsResourceId

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

Объект KeyVault.

Свойства параметра

Тип:	PSKeyVault
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByNameInputObject

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateNameAndVersionInputObject

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateAllVersionsInputObject

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InRemovedState

Указывает, следует ли включать ранее удаленные сертификаты в выходные данные.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByNameInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByNameResourceId

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

Указывает имя сертификата, который требуется получить.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False
Aliases:	CertificateName

Наборы параметров

ByName

Position:	1
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByNameInputObject

Position:	1
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByNameResourceId

Position:	1
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ResourceId

Идентификатор ресурса KeyVault.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByNameResourceId

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

ByCertificateNameAndVersionResourceId

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

ByCertificateAllVersionsResourceId

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-VaultName

Указывает имя хранилища ключей.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByName

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateNameAndVersion

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateAllVersions

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Version

Указывает версию сертификата.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	CertificateVersion

Наборы параметров

ByCertificateNameAndVersion

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateNameAndVersionInputObject

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByCertificateNameAndVersionResourceId

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

PSKeyVault

String

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

Get-AzKeyVaultCertificate

Синтаксис

ByName (по умолчанию)

ByCertificateNameAndVersion

ByCertificateAllVersions

ByNameInputObject

ByCertificateNameAndVersionInputObject

ByCertificateAllVersionsInputObject

ByNameResourceId

ByCertificateNameAndVersionResourceId

ByCertificateAllVersionsResourceId

Описание

Примеры

Пример 1. Получение сертификата

Пример 2. Получение сертификата и сохранение его в виде PFX

Пример 3. Получение всех сертификатов, которые были удалены, но не удалены для этого хранилища ключей.

Пример 4. Возвращает сертификат MyCert, который был удален, но не удален для этого хранилища ключей.

Пример 5. Вывод списка сертификатов с помощью фильтрации

Параметры

-DefaultProfile

Свойства параметра

Наборы параметров

-IncludePending

Свойства параметра

Наборы параметров

-IncludeVersions

Свойства параметра

Наборы параметров

-InputObject

Свойства параметра

Наборы параметров

-InRemovedState

Свойства параметра

Наборы параметров

-Name

Свойства параметра

Наборы параметров

-ResourceId

Свойства параметра

Наборы параметров

-VaultName

Свойства параметра

Наборы параметров

-Version

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

PSKeyVault

String

Выходные данные

PSKeyVaultCertificateIdentityItem

PSKeyVaultCertificate

PSDeletedKeyVaultCertificate

PSDeletedKeyVaultCertificateIdentityItem

Связанные ссылки

Обратная связь