Set-TrustedCluster
This cmdlet modifies the configuration of the trusted clusters in the workload vCenter Server system.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
State | TrustedState | named |
|
Specifies the state in which you want to update the specified trusted clusters. If you specify Enabled, the cmdlet will push all the ServiceInfos, including the AttestationServiceInfos and the KeyProviderServiceInfos configured in the vCenter Server system, to the specified trusted clusters. However, if there are no AttestationServiceInfos configured in the vCenter Server system, the cmdlet will fail. If you specify Disabled, the cmdlet will clear all the ServiceInfos configured in the specified trusted clusters. Note: In vCenter Server 7.0 Update 1 and later, a warning message appears if the given trusted cluster is unhealthy in the TrustedClusterAppliedStatus. This cmdlet remediates it automatically. |
| required
|
TrustedCluster | TrustedCluster[] | named |
|
Specifies the trusted clusters you want to update. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Server | 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. |
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
Remediate | SwitchParameter | named |
|
Indicates that you want to remediate the given trusted cluster to make the applied status healthy. Note: This parameter is only available for the vCenter Server system 7.0 Update 1 and later. |
| required
|
TrustedCluster | TrustedCluster[] | named |
|
Specifies the trusted clusters you want to update. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Server | 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. |
Output
VMware.VimAutomation.Security.Types.V1.TrustedInfrastructure.TrustedClusterExamples
Example 1
Set-TrustedCluster -TrustedCluster mycluster -State Enabled
Copies the attestation service information and key provider service information from the workload vCenter Server system to the specified mycluster trusted cluster.
Example 2
Set-TrustedCluster -TrustedCluster mycluster -Remediate
Remedites the mycluster trusted cluster. All trusted services on all virtual machine hosts in the mycluster trusted cluster become consistent with the desired state of the mycluster trusted cluster.
Related Commands
TrustedCluster
This cmdlet retrieves the trusted clusters from the connected workload vCenter Server system.
This cmdlet modifies the configuration of the trusted clusters in the workload vCenter Server system.
TrustedClusterAppliedStatus
This cmdlet retrieves the applied status of the trusted service information on the trusted clusters in the workload vCenter Server system.
TrustedClusterAttestationServiceInfo
This cmdlet adds the attestation service information configured in the workload vCenter Server system to the trusted hosts in the given trusted cluster.
This cmdlet removes the attestation services information from the specified trusted cluster in the workload vCenter Server system.
TrustedClusterKeyProviderServiceInfo
This cmdlet adds the key provider service information configured in the workload vCenter Server system to the trusted hosts in the given trusted cluster.
This cmdlet removes the key provider services information from the specified trusted cluster in the workload vCenter Server system.