Set-HcsRemoteManagementCert

Generates the certificate for remote management.

Parameter Set: Default
Set-HcsRemoteManagementCert [-CN <String[]> ] [-Force] [ <CommonParameters>]

The Set-HcsRemoteManagementCert cmdlet generates the certificate for Windows PowerShell® remote management. This cmdlet creates a new certificate and invalidates the old certificate. After the cmdlet finishes, you must install the new certificate on all client machines, and update their hosts files to map the values specified by the CN parameter.

Specifies an array of common name (CN) values for the CN field of remote management certificates. To connect to the device by using HTTPS, you can use only names that are in the CN field of the remote management certificate. To connect to the device by using HTTP, you can use the IP addresses in addition to CNs.

On the client, you must install the remote management certificate in the trusted root certificate store, and then map each CN entry to an IP address of the device.

The device comes preinstalled with a certificate containing the names <Serial Number>, <Serial Number>Controller0, and <Serial Number>Controller1. <Serial Number> is the SerialNumber property of the output of the Get-HcsSystem cmdlet. SerialNumber is also the default value of the CN parameter.

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

The input type is the type of the objects that you can pipe to the cmdlet.

The output type is the type of the objects that the cmdlet emits.

This command generates a certificate for Windows PowerShell remote management.

PS C:\> Set-HcsRemoteManagementCert

Get-HcsRemoteManagementCert

Get-HcsSystem