New-RDMSSHKey

Synopsis

Créer une clé SSH.

Syntaxe

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>]

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

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

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

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

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.

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.

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

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.

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.

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)

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

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.

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.

Sorties

Notes

Pour plus d'informations, saisissez « Get-Help New-RDMSSHKey -detailed ». Pour les informations techniques, saisissez « Get-Help New-RDMSSHKey -full ».