< Back

Get-RDCertificate

Thu Apr 04, 2019 5:41 am

NAME Get-RDCertificate



SYNOPSIS

Gets certificates associated with RDS roles.





SYNTAX

Get-RDCertificate [[-Role] {RDGateway | RDWebAccess | RDRedirector | RDPublishing}] [-ConnectionBroker <String>] [<CommonParameters>]





DESCRIPTION

The Get-RDCertificate cmdlet gets certificates associated with Remote Desktop Services (RDS) roles.



This cmdlet modifies an object that contains the following information:



-- Subject. The subject of the certificate.

-- SubjectAlternateName. A list of subject alternative name entries of the certificate.

-- IssuedBy. Common name of the issuer of the certificate.

-- IssuedTo. Common name of the IssuedTo field of the certificate.

-- ExpiresOn. Expiration date of the certificate.

-- Thumbprint. Thumbprint of the certificate.

-- Role. Remote desktop role service name. The possible roles are: RDGateway, RDWebAccess, RDRedirector, and RDPublishing.

-- Level. Certification level.



The certification levels are:



-- Not Configured. The role service is not configured with a certificate or the certificate is not valid.

-- Untrusted. The role service is configured with a self-signed certificate.

-- Trusted. The role service is configured with either enterprise certificate or public certificate.





PARAMETERS

-ConnectionBroker [<String>]

Specifies the Remote Desktop Connection Broker (RDConnection Broker) server for a Remote Desktop deployment. If you do not specify a value,

the cmdlet uses the fully qualified domain name (FQDN) of the local computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Role [<RDCertificateRole>]

Specifies a certificate type associated with an RDS server role. The acceptable values for this parameter are:



-- RDGateway

-- RDWebAccess

-- RDRedirector

-- RDPublishing



Required? false

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS









OUTPUTS

System.Object







Example 1: Get certificates for an RD?? Connection Broker



PS C:\\> Get-RDCertificate -ConnectionBroker "RDConnectionBroker.Contoso.com"



This command gets certificates for server roles for the RD?? Connection Broker server named RDConnectionBroker.Contoso.com.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294211

New-RDCertificate

Set-RDCertificate