PowerCLI Reference

Set-KeyProvider

Synopsis

This cmdlet modifies the settings of the specified key provider.

Syntax

Set-KeyProvider [-KeyProvider] <KmsCluster> [-KmsProvidedClientCertificate <String>] [-KmsProvidedClientCertificateFilePath <String>] [-KmsProvidedPrivateKey <SecureString>] [-KmsProvidedPrivateKeyFilePath <String>] [-DefaultForSystem] [-Server <VIServer[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-KeyProvider [-KeyProvider] <KmsCluster> [-KmsSignedClientCertificate <String>] [-KmsSignedClientCertificateFilePath <String>] [-DefaultForSystem] [-Server <VIServer[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-KeyProvider [-KeyProvider] <KmsCluster> [-SelfSignedClientCertificate <String>] [-SelfSignedClientCertificateFilePath <String>] [-DefaultForSystem] [-Server <VIServer[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Related Commands

Online Version
Get-KeyProvider

Detailed Description

This cmdlet modifies the settings of the specified key provider.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
KeyProviderKmsClusterSpecifies the key provider you want to modify.trueTrue (ByValue)
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falseFalse
DefaultForSystemSwitchParameterSpecifies the key provider you want to use as the vCenter Server system default key provider.falseFalse
KmsProvidedClientCertificateStringSpecifies the certificate provided by the key management server and its private key. Either this parameter or the KmsProvidedClientCertificateFilePath parameter should be specified.falseFalse
KmsProvidedClientCertificateFilePathStringSpecifies the file path to the certificate file provided by the key management server. Either this parameter or the KmsProvidedClientCertificate parameter should be specified.falseFalse
KmsProvidedPrivateKeySecureStringSpecifies the private key for the key provider, if it is provided by the key management server. Either this parameter or the KmsProvidedPrivateKeyFilePath parameter should be specified.falseFalse
KmsProvidedPrivateKeyFilePathStringSpecifies the private key file path provided by the key management server. Either this parameter or the KmsProvidedPrivateKey parameter should be specified.falseFalse
KmsSignedClientCertificateStringUploads the key management server-signed client certificate for the key provider. The server uses the certificate for authentication with the key management server in the key provider. Either this parameter or the KmsSignedClientCertificateFilePath parameter should be specified.falseFalse
KmsSignedClientCertificateFilePathStringSpecifies the file path to the certificate file signed by the key management server. Either this parameter or the KmsSignedClientCertificate parameter should be specified.falseFalse
SelfSignedClientCertificateStringSpecifies the self-signed certificate for the key provider. The server uses the certificate for authentication with the key management server in the key provider. Either this parameter or the SelfSignedClientCertificateFilePath parameter should be specified.falseFalse
SelfSignedClientCertificateFilePathStringSpecifies the file path to the self-signed certificate. Either this parameter or the SelfSignedClientCertificate parameter should be specified.falseFalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet.falseFalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

Return Type

The list of modified KeyProvider objects

Notes

Examples

-------------------------- Example 1 --------------------------

Set-KeyProvider -KeyProvider $keyProvider -SelfSignedClientCertificate $certificate -DefaultForSystem

Updates the client certificate with the $certificate self-signed certificate and marks the $keyProvider key provider as the system default key provider.

-------------------------- Example 2 --------------------------

Set-KeyProvider -KeyProvider $keyProvider -KmsProvidedClientCertificate $certificate -KmsProvidedPrivateKey $privateKey

Updates the client certificate and its private key with $certificate and $privateKey for the $keyProvider key provider.


Copyright © VMware, Inc. All rights reserved.