Get-SCCertificate
Applies To: System Center 2012 - Virtual Machine Manager
Get-SCCertificate
Gets a security certificate object from a VMware vCenter Server, from a VMware ESX host, or from a Citrix XenServer host.
Syntax
Parameter Set: Default
Get-SCCertificate [-ComputerName] <String> [-TCPPort <UInt32> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The Get-SCCertificate cmdlet gets a security certificate object from a vCenter Server, from an ESX host, or from a XenServer host. You can use this cmdlet to import a non-trusted certificate into System Center Virtual Machine Manager (VMM) so that you can use the certificate with the Add-SCVirtualizationManager cmdlet, the Set-SCVirtualizationManager cmdlet, the Add-SCVMHost cmdlet or the Set-SCVMHost cmdlet.
The certificate is required in order to establish an SSL connection between the VMM server and the vCenter Server, ESX host, or XenServer host.
For more information about Get-SCCertificate, type: "Get-Help Get-SCCertificate -online".
Parameters
-ComputerName<String>
Specifies the name of a computer that VMM can uniquely identify on your network. Valid formats are: FQDN, IPv4 or IPv6 address, or NetBIOS name.
NOTE: See the examples for a specific cmdlet to determine how that cmdlet specifies the computer name.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TCPPort<UInt32>
Specifies a numeric value that represents a TCP port.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-VMMServer<ServerConnection>
Specifies a VMM server object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- Certificate
Examples
1: Retrieve the security certificate for the specified VMware vCenter Server.
This command gets the security certificate object for the vCenter Server server named vCenterServer01 located in the Contoso.com domain, and displays the security certficate information.
PS C:\> Get-SCCertificate -Computername "vCenterServer01.Contoso.com"
2: Retrieve the security certificate for a specified VMware ESX host.
The first command gets the security certificate object from the ESX host named ESXHost01 and stores the object in the $ESXCert variable.
The second command passes the contents of $ESXCert to the Get-Member cmdlet, which displays the .NET type and a list of methods and properties for the certificate object.
PS C:\> $ESXCert = Get-SCCertificate -ComputerName "ESXHost01.Contoso.com"
PS C:\> $ESXCert | Get-Member
3: Retrieve the security certificate for the specified Citrix XenServer host.
This command gets the security certificate object for the XenServer named XenServer01 located in the Contoso.com domain, and displays the security certficate information.
PS C:\> Get-SCCertificate -Computername "XenServer01.Contoso.com"