Set-TrustedCluster Command | Vmware PowerCLI Reference

Set-TrustedCluster

This cmdlet modifies the configuration of the trusted clusters in the workload vCenter Server system.

Syntax

Set-TrustedCluster
-State < TrustedState >
-TrustedCluster < TrustedCluster[] >
[-ProgressAction < ActionPreference > ]
[-Server < VIServer[] > ]
[CommonParameters]

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
  • pipeline
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.
Set-TrustedCluster
-Remediate
-TrustedCluster < TrustedCluster[] >
[-ProgressAction < ActionPreference > ]
[-Server < VIServer[] > ]
[CommonParameters]

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
  • pipeline
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.TrustedCluster

Examples

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.