Import-RDMX509Certificate

Sintesi

Importa un certificato X509.

Sintassi

__AllParameterSets

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

Descrizione

Importa un certificato X509. Richiede come parametri obbligatori la voce di certificato da sovrascrivere e il percorso del nuovo file di certificato. Se il nuovo certificato è in formato .pfx, il comando richiede inoltre la password del certificato. Se il nuovo certificato è in formato .pem o .der, il comando richiede inoltre il percorso del file della chiave privata del certificato. L'utente deve disporre dei diritti di aggiunta o modifica.

Esempi

Esempio 1

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

Importa un certificato .pfx dal percorso fornito, utilizzando la password richiesta (12345), e aggiorna la voce di certificato X509 'MyOtherCert' con i suoi valori.

Esempio 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

Importa un certificato .pem dal percorso fornito, utilizzando il percorso della chiave privata richiesto, e aggiorna la voce di certificato X509 'MyOtherCert' con i suoi valori.

Parametri

-Confirm

Richiede una conferma prima di eseguire il cmdlet.

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

Parametro switch da usare con cautela. Risponderà automaticamente alle richieste che pongono domande sì/no, sì/no/annulla oppure ok/annulla. In caso di più richieste, è possibile passare più valori a questo parametro. Di seguito i valori accettati:

• Yes: accetta la richiesta. Copre i valori OK e Automatic.
• No: rifiuta la richiesta sì/no/annulla. "Cancel" è l'opzione di riserva se non è presente l'opzione "No".
• Cancel: annulla la richiesta sì/no/annulla. "No" è l'opzione di riserva se non è presente l'opzione "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

Oggetto PSConnection fornito esplicitamente.

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

Password per accedere al certificato.

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

Percorso del file di certificato da verificare.

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

Percorso del file della chiave privata per accedere al certificato. Lasciare vuoto se non si desidera includere una chiave privata.

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

Cassaforte a cui verrà applicato il comando. Sono offerte tre scelte:

• Default: cassaforte corrente impostata.
• User: cassaforte specifica dell'utente corrente.
• Global: cassaforte globale dello spazio di lavoro.

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

Mostra cosa accadrebbe se il cmdlet venisse eseguito. Il cmdlet non viene eseguito.

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

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per maggiori informazioni, veda about_CommonParameters.

Note

Per maggiori informazioni, digiti "Get-Help Import-RDMX509Certificate -detailed". Per informazioni tecniche, digiti "Get-Help Import-RDMX509Certificate -full".