Add-KeyManagementServer
This cmdlet adds a key management server to a vCenter Server system.
Syntax
[-KeyProvider]
<String>
-Address <String>
-Name <String>
-Port <Int32>
-TrustKeyManagementServer <Boolean>
[-Credential <PSCredential>]
[-Password <SecureString>]
[-ProxyAddress <String>]
[-ProxyPort <Int32>]
[-Server <VIServer[]>]
[-Username <String>]
[CommonParameters]
-Address <String>
-Name <String>
-Port <Int32>
-TrustKeyManagementServer <Boolean>
[-Credential <PSCredential>]
[-Password <SecureString>]
[-ProxyAddress <String>]
[-ProxyPort <Int32>]
[-Server <VIServer[]>]
[-Username <String>]
[CommonParameters]
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required |
|
String | 1 |
|
Specifies the key provider to which you want to add the key management server. This parameter also accepts objects of type KmsCluster through an ArgumentTransformationAttribute object. | required |
|
String | named |
|
Specifies the address of the Key Management Interoperability Protocol server. | required |
|
String | named |
|
Specifies the name of the Key Management Interoperability Protocol server you want to add. | required |
|
Int32 | named |
|
Specifies the port number of the Key Management Interoperability Protocol server. | required |
|
Boolean | named |
|
Indicates whether the vCenter Server system can trust the key management server certificate. | optional |
|
PSCredential | named |
|
Specifies a PSCredential object that contains credentials for authenticating with the key management server. | optional |
|
SecureString | named |
|
Specifies the password you want to use for authenticating with the Key Management Interoperability Protocol server. | optional |
|
String | named |
|
Specifies the address of the proxy server. | optional |
|
Int32 | named |
|
Specifies the port number of the proxy server. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | optional |
|
String | named |
|
Specifies the user name you want to use for authenticating with the Key Management Interoperability Protocol server. |
Output
VMware.VimAutomation.Storage.Types.V1.Encryption.KeyManagementServer
Examples
Example 1
Add-KeyManagementServer -Name 'KMS' -KeyProvider 'KeyProvider' -Address $kmsAddress -Port $kmsPort -ProxyAddress $proxyAddress -ProxyPort $proxyPort -TrustKeyManagementServer $true
Adds the key management server named 'KMS' to the 'KeyProvider' key provider that runs at the $kmsAddress address, $kmsPort port, and trusts the key management server certificate.
Related Commands
KeyManagementServer
This cmdlet retrieves the key management servers registered on the vCenter Server system.
This cmdlet adds a key management server to a vCenter Server system.
This cmdlet configures the settings of the key management server.
This cmdlet removes the specified key management servers from the vCenter Server systems.
KeyProvider
This cmdlet retrieves all key providers from the vCenter Server system.
This cmdlet modifies the settings of the specified key provider.