Import-RDMX509Certificate

Synopsis

Importe un certificat X509.

Syntaxe

__AllParameterSets

Import-RDMX509Certificate [-Path] <string> [[-Password] <string>] [[-PrivateKeyPath] <string>]
 -InputObject <PSConnection> [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>]
 [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Importe un certificat X509. Prend comme paramètres obligatoires l'entrée de certificat à écraser et le chemin vers le nouveau fichier de certificat. Si le nouveau certificat est au format .pfx, la commande nécessite également le mot de passe du certificat. Si le nouveau certificat est au format .pem ou .der, la commande nécessite également le chemin vers le fichier de clé privée du certificat. L'utilisateur doit disposer des droits d'ajout ou de modification.

Exemples

Exemple 1

PS C:\> Get-RDMEntry -IncludeDocumentsStoredInDatabase -IncludeLocalPlaylists -IncludeUserSpecificSettings -Name MyOtherCert | 
    Import-RDMX509Certificate C:\Users\myuser\Downloads\certtest.pfx 12345

Importe un certificat .pfx depuis le chemin fourni, en utilisant son mot de passe obligatoire (12345), et met à jour l'entrée de certificat X509 'MyOtherCert' avec ses valeurs.

Exemple 2

PS C:\> $CertToOverwrite = Get-RDMEntry -IncludeDocumentsStoredInDatabase -IncludeLocalPlaylists -IncludeUserSpecificSettings -Name MyOtherCert;
    Import-RDMX509Certificate C:\Users\myuser\Downloads\PemFile.pem -PrivateKeyPath C:\Users\myuser\Downloads\PemKeyFile.key -InputObject $CertToOverwrite

Importe un certificat .pem depuis le chemin fourni, en utilisant le chemin de clé privée obligatoire, et met à jour l'entrée de certificat X509 'MyOtherCert' avec ses valeurs.

Paramètres

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ForcePromptAnswer

Paramètre à utiliser avec prudence. Il répondra automatiquement aux invites posant des questions oui/non, oui/non/annuler ou ok/annuler. En cas d'invites multiples, plusieurs valeurs peuvent être transmises à ce paramètre. Voici les valeurs acceptées :

• Yes : Accepte l'invite. Couvre les valeurs OK et Automatic.
• No : Refuse l'invite oui/non/annuler. « Cancel » est l'option de repli s'il n'existe pas d'option « No ».
• Cancel : Annule l'invite oui/non/annuler. « No » est l'option de repli s'il n'existe pas d'option « Cancel ».

Type: System.Windows.Forms.DialogResult[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Objet PSConnection fourni explicitement.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Password

Mot de passe pour accéder au certificat.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Chemin du fichier de certificat à vérifier.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PrivateKeyPath

Chemin du fichier de clé privée pour accéder au certificat. Laissez ce champ vide si vous ne souhaitez pas inclure de clé privée.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-VaultMode

Coffre auquel la commande sera appliquée. Trois choix sont proposés :

• Default : Coffre actuel qui a été défini.
• User : Coffre spécifique à l'utilisateur actuel.
• Global : Coffre global de l'espace de travail.

Type: Devolutions.RemoteDesktopManager.VaultMode
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Affiche ce qui se passerait si l'applet de commande s'exécutait. L'applet de commande n'est pas exécutée.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, consultez about_CommonParameters.

Notes

Pour plus d'informations, tapez « Get-Help Import-RDMX509Certificate -detailed ». Pour les informations techniques, tapez « Get-Help Import-RDMX509Certificate -full ».