Import-RDMX509Certificate

Sinopsis

Importa un certificado X509.

Sintaxis

__AllParameterSets

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

Descripción

Importa un certificado X509. Toma como parámetros obligatorios la entrada de certificado que se sobrescribirá y la ruta al nuevo fichero de certificado. Si el nuevo certificado tiene formato .pfx, el comando requiere además la contraseña del certificado. Si el nuevo certificado tiene formato .pem o .der, el comando requiere además la ruta al fichero de clave privada del certificado. El usuario necesita derechos de añadir o editar.

Ejemplos

Ejemplo 1

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

Importa un certificado .pfx desde la ruta indicada, utilizando su contraseña obligatoria (12345), y actualiza la entrada de certificado X509 'MyOtherCert' con sus valores.

Ejemplo 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 certificado .pem desde la ruta indicada, utilizando la ruta obligatoria de su clave privada, y actualiza la entrada de certificado X509 'MyOtherCert' con sus valores.

Parámetros

-Confirm

Le solicita confirmación antes de ejecutar el 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

Modificador que debe usarse con precaución. Responderá automáticamente a las solicitudes que planteen preguntas de sí/no, sí/no/cancelar u ok/cancelar. En caso de múltiples solicitudes, se pueden pasar varios valores a este parámetro. Estos son los valores aceptados:

• Yes: acepta la solicitud. Cubre el valor OK y el valor automático.
• No: rechaza la solicitud sí/no/cancelar. "Cancel" es la opción alternativa si no existe la opción "No".
• Cancel: cancela la solicitud sí/no/cancelar. "No" es la opción alternativa si no existe la opción "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

Objeto PSConnection proporcionado explícitamente.

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

Contraseña para acceder al certificado.

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

Ruta del fichero de certificado que se comprobará.

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

Ruta del fichero de clave privada para acceder al certificado. Déjelo en blanco si no desea incluir una clave privada.

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

Bóveda donde se aplicará el comando. Se ofrecen tres opciones:

• Default: bóveda actual que se ha establecido.
• User: bóveda específica del usuario actual.
• Global: bóveda global del espacio de trabajo.

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

Muestra lo que ocurriría si se ejecutase el cmdlet. El cmdlet no se ejecuta.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Notas

Para más información, escriba "Get-Help Import-RDMX509Certificate -detailed". Para obtener información técnica, escriba "Get-Help Import-RDMX509Certificate -full".