> 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/de/powershell-commands/new-rdmsshkey.md). # New-RDMSSHKey ### Synopsis Erstellt einen SSH-Schlüssel. ### Syntax #### 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 ] [] ``` ### Beschreibung Erstellt einen SSH-Schlüssel. Der öffentliche Schlüssel wird zurückgegeben. Es besteht auch die Möglichkeit, eine Datei mit dem öffentlichen oder privaten Schlüssel zu speichern. Eine Passphrase kann verwendet werden, um die Datei mit dem privaten Schlüssel zu schützen. In beiden Fällen wird eine bestehende Datei überschrieben. ### Beispiele #### Beispiel 1 ```powershell PS C:\> $pubKey = New-RDMSSHkey -Algorithm RSA -Comment username@hostname -Size 2048 ``` Erstellt einen öffentlichen SSH-Schlüssel mit 2048 Bit unter Verwendung von RSA im Format Putty. Der resultierende Schlüssel endet mit dem Kommentar (username\@hostname). #### Beispiel 2 ```powershell PS C:\> $pubKey = New-RDMSSHkey ECDSA -Comment username@hostname -Size 256 -SavePublicKey C:\mypath\sshPublicKey.pub ``` Erstellt einen öffentlichen SSH-Schlüssel mit 256 Bit unter Verwendung von ECDSA mit dem Kommentar username\@hostname. Der Schlüssel wird in der Datei C:\mypath\sshPublicKey.pub gespeichert. Wenn die Datei bereits existiert, wird sie überschrieben. #### Beispiel 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 ``` Zuerst wird das zum Verschlüsseln der Datei verwendete Passwort aus der Eingabe des Benutzers generiert. Erstellt einen privaten SSH-Schlüssel mit 521 Bit unter Verwendung von ECDSA mit einem leeren Kommentar. Der Schlüssel wird in der Datei C:\mypath\sshPrivateKey.pri gespeichert. Das verwendete Format ist PKCS8 mit der Verschlüsselung SHA1\_RC4\_128 und 64 Runden. Wenn die verwendete Passphrase leer ist, findet keine Verschlüsselung statt. #### Beispiel 4 ```powershell PS C:\> $pubKey = New-RDMSSHkey -Algorithm ECDSA -Comment username@hostname -Format PKCS8 -Size 521 -Round 64 -SavePrivateKey C:\mypath\sshPrivateKey.pri ``` Erstellt einen privaten SSH-Schlüssel mit 521 Bit unter Verwendung von ECDSA mit dem Kommentar username\@hostname. Der Schlüssel wird in der Datei C:\mypath\sshPrivateKey.pri gespeichert und ist nicht verschlüsselt. ### Parameter #### -Algorithm Der Algorithmus, der zum Generieren des SSH-Schlüssels verwendet wird. ```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 Der Kommentar am Ende eines öffentlichen Schlüssels. Leerzeichen sind nicht erlaubt. ```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 Schalter, der mit Vorsicht zu verwenden ist. Er beantwortet automatisch Eingabeaufforderungen mit yes/no-, yes/no/cancel- oder ok/cancel-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Dies sind die zulässigen Werte: * Yes: Bestätigt die Eingabeaufforderung. Deckt den Wert OK und Automatic ab. * No: Lehnt die yes/no/cancel-Eingabeaufforderung ab. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist. * Cancel: Bricht die yes/no/cancel-Eingabeaufforderung ab. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist. ```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 Das Format, das zum Speichern des privaten Schlüssels verwendet wird. ```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 Passphrase, die zum Schutz der Datei mit dem privaten Schlüssel verwendet wird. Ein leerer SecureString wird akzeptiert, was bedeutet, dass keine Verschlüsselung stattfindet. ```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 Speichert den privaten Schlüssel in einer Datei im angegebenen Pfad. Die unterstützten Erweiterungen sind: PKCS#1/OpenSSL (*.key), PKCS#8 (*.pri) und 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 Speichert den öffentlichen Schlüssel in einer Datei im angegebenen Pfad. Die unterstützte Erweiterung ist (\*.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 Die Anzahl der Bits im Schlüssel für die Algorithmen RSA und ECDSA. Für RSA ist der Standardwert 2048 und die gültigen Werte sind: 1024, 2048, 3072, 4096, 6144 und 8192. Für ECDSA ist der Standardwert 256 und die gültigen Werte sind: 256, 384 und 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 Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Ausgaben ### Hinweise Weitere Informationen erhalten Sie mit "Get-Help New-RDMSSHKey -detailed". Technische Informationen erhalten Sie mit "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, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell/de/powershell-commands/new-rdmsshkey.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.