Set-RDCertificate
Aggiornamento: giugno 2015
Si applica a: Windows 10, Windows Server Technical Preview
Set-RDCertificate
Imports and secures a certificate to use with an RDS role.
Sintassi
Parameter Set: Reapply
Set-RDCertificate [-Role] <RDCertificateRole> {RDGateway | RDWebAccess | RDRedirector | RDPublishing} [-ConnectionBroker <String> ] [-Force] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Password <SecureString> ] [ <CommonParameters>]
Parameter Set: Import
Set-RDCertificate [-Role] <RDCertificateRole> {RDGateway | RDWebAccess | RDRedirector | RDPublishing} [-ConnectionBroker <String> ] [-Force] [-ImportPath <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Password <SecureString> ] [ <CommonParameters>]
Descrizione dettagliata
The Set-RDCertificate cmdlet imports a certificate to use with a Remote Desktop Services (RDS) role. The cmldet helps secure a certificate by using a secure string supplied by the user. You can use this cmdlet to apply a new secure string for an existing certificate.
Parametri
-ConnectionBroker<String>
Specifies the Remote Desktop Connection Broker (RD Connection 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.
Alias |
none |
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
-Force
Performs the action without a confirmation message.
Alias |
none |
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
-ImportPath<String>
Specifies the location of a certificate as a file that has a .pfx extension.
Alias |
none |
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Alias |
infa |
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
Alias |
iv |
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
-Password<SecureString>
Specifies a secure string used to help secure the certificate. See the Examples section.
Alias |
none |
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
-Role<RDCertificateRole>
Specifies a certificate type associated with an RDS server role. I valori accettabili per questo parametro sono:
-- RDGateway
-- RDWebAccess
-- RDRedirector
-- RDPublishing
Alias |
none |
Obbligatorio? |
true |
Posizione? |
1 |
Valore predefinito |
none |
Accettare l'input della pipeline? |
false |
Accetta caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per altre informazioni, vedere about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Input
Il tipo di input è il tipo di oggetti che è possibile inviare al cmdlet.
Output
Il tipo di output corrisponde al tipo di oggetti emesso dal cmdlet.
- Null
Esempi
Example 1: Import a certificate to use with RDS
This example imports a certificate to use with an RDS role.
The first command uses the ConvertTo-SecureString cmdlet to create a secure string based on a string that the user supplies, and stores it in the $Password variable. For more information, type Get-Help ConvertTo-SecureString
.
The second command specifies the file name of the certificate to use for the redirector role for the RD Connection Broker named RDCB.Contoso.com. The command uses the secure string stored in the $Password variable to help secure the certificate.
PS C:\> $Password = ConvertTo-SecureString -String "Cups34Horses&&" -AsPlainText -Force
PS C:\> Set-RDCertificate -Role RDRedirector -ImportPath "C:\Certificates\Redirector07.pfx" -Password $Password -ConnectionBroker "RDCB.Contoso.com"
Example 2: Apply a secure string to a certificate
This example applies a new secure string to a certificate used for an RDS role.
The first command uses the ConvertTo-SecureString cmdlet to create a secure string based on a string that the user supplies, and stores it in the $Password variable.
The second command uses the secure string stored in the $Password variable to secure the certificate used for the redirector role for the RD Connection Broker named RDCB.Contoso.com.
PS C:\> $Password = ConvertTo-SecureString -String "Wings%%83Potato" -AsPlainText -Force
PS C:\> Set-RDCertificate -Role RDRedirector -Password $Password -ConnectionBroker "RDCB.Contoso.com"