> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell/fr/powershell-commands/new-rdmsshkey.md). # New-RDMSSHKey ### Synopsis Créer une clé SSH. ### Syntaxe #### Private ``` New-RDMSSHKey [-Algorithm] -Format [-Comment ] [-SavePrivateKey ] [-Size ] [-ForcePromptAnswer ] [] ``` #### EncryptedPrivate ``` New-RDMSSHKey [-Algorithm] -Format -Passphrase [-Comment ] [-SavePrivateKey ] [-Size ] [-ForcePromptAnswer ] [] ``` #### Public ``` New-RDMSSHKey [-Algorithm] [-Comment ] [-SavePublicKey ] [-Size ] [-ForcePromptAnswer ] [] ``` ### Description Créer une clé SSH. La clé publique sera retournée. Il est également possible d'enregistrer un fichier de clé publique ou privée. Une phrase secrète peut être utilisée pour protéger le fichier de clé privée. Dans les deux cas, un fichier existant sera écrasé. ### Exemples #### Exemple 1 ```powershell PS C:\> $pubKey = New-RDMSSHkey -Algorithm RSA -Comment username@hostname -Size 2048 ``` Créer une clé publique SSH de 2048 bits en utilisant RSA, dont le format est Putty. La clé résultante se termine par le commentaire (username\@hostname). #### Exemple 2 ```powershell PS C:\> $pubKey = New-RDMSSHkey ECDSA -Comment username@hostname -Size 256 -SavePublicKey C:\mypath\sshPublicKey.pub ``` Créer une clé publique SSH de 256 bits en utilisant ECDSA avec le commentaire username\@hostname. La clé est enregistrée dans le fichier C:\mypath\sshPublicKey.pub. Si le fichier existe, il sera écrasé. #### Exemple 3 ```powershell PS C:\> $passwd = Read-Host -AsSecureString; $pubKey = New-RDMSSHkey -Algorithm ECDSA -Format PKCS8 -Encryption SHA1_RC4_128 -Size 521 -Round 64 -SavePrivateKey C:\mypath\sshPrivateKey.pri -Passphrase $passwd ``` Premièrement, le mot de passe utilisé pour chiffrer le fichier est généré à partir de la saisie de l'utilisateur. Créer une clé privée SSH de 521 bits en utilisant ECDSA avec un commentaire vide. La clé est enregistrée dans le fichier C:\mypath\sshPrivateKey.pri. Le format utilisé est PKCS8 avec le chiffrement SHA1\_RC4\_128 et 64 tours. Si la phrase secrète utilisée est vide, aucun chiffrement ne se produira. #### Exemple 4 ```powershell PS C:\> $pubKey = New-RDMSSHkey -Algorithm ECDSA -Comment username@hostname -Format PKCS8 -Size 521 -Round 64 -SavePrivateKey C:\mypath\sshPrivateKey.pri ``` Créer une clé privée SSH de 521 bits en utilisant ECDSA avec le commentaire username\@hostname. La clé est enregistrée dans le fichier C:\mypath\sshPrivateKey.pri et n'est pas chiffrée. ### Paramètres #### -Algorithm L'algorithme utilisé pour générer la clé SSH. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Comment Le commentaire à la fin d'une clé publique. Les espaces ne sont pas autorisés. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] 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 demandant 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 : Accepter l'invite. Couvre les valeurs OK et Automatic. * No : Refuser l'invite oui/non/annuler. « Cancel » est l'option de repli s'il n'y a pas d'option « No ». * Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de repli s'il n'y a pas d'option « Cancel ». ```yaml 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: '' ``` #### -Format Le format utilisé pour stocker la clé privée. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: Private Position: Named IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false - Name: EncryptedPrivate Position: Named IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Passphrase Phrase secrète utilisée pour protéger le fichier de clé privée. Une SecureString vide est acceptée, ce qui signifie qu'aucun chiffrement ne se produira. ```yaml Type: System.Security.SecureString DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: EncryptedPrivate Position: Named IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -SavePrivateKey Enregistrer la clé privée dans un fichier au chemin spécifié. Les extensions prises en charge sont : PKCS#1/OpenSSL (*.key), PKCS#8 (*.pri) et PuTTY (\*ppk) ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: Private Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false - Name: EncryptedPrivate Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -SavePublicKey Enregistrer la clé publique dans un fichier au chemin spécifié. L'extension prise en charge est (\*.pub). ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: Public Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Size Le nombre de bits dans la clé pour les algorithmes RSA et ECDSA. Pour RSA, la valeur par défaut est 2048 et les valeurs valides sont : 1024, 2048, 3072, 4096, 6144 et 8192. Pour ECDSA, la valeur par défaut est 256 et les valeurs valides sont : 256, 384 et 521. ```yaml Type: System.Int32 DefaultValue: '' SupportsWildcards: false Aliases: [] 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](https://go.microsoft.com/fwlink/?LinkID=113216). ### Sorties ### Notes Pour plus d'informations, saisissez « Get-Help New-RDMSSHKey -detailed ». Pour les informations techniques, saisissez « Get-Help New-RDMSSHKey -full ». --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.devolutions.net/powershell/fr/powershell-commands/new-rdmsshkey.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.