New-RDMSSHKey

Synopsis

Erstellt einen SSH-Schlüssel.

Syntax

Private

New-RDMSSHKey [-Algorithm] <string> -Format <string> [-Comment <string>] [-SavePrivateKey <string>]
 [-Size <int>] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

EncryptedPrivate

New-RDMSSHKey [-Algorithm] <string> -Format <string> -Passphrase <securestring> [-Comment <string>]
 [-SavePrivateKey <string>] [-Size <int>] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Public

New-RDMSSHKey [-Algorithm] <string> [-Comment <string>] [-SavePublicKey <string>] [-Size <int>]
 [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

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

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

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

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

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.

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.

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.

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.

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.

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)

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).

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.

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.

Ausgaben

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help New-RDMSSHKey -detailed". Technische Informationen erhalten Sie mit "Get-Help New-RDMSSHKey -full".