Import-RDMX509Certificate

Übersicht

Importiert ein X509-Zertifikat.

Syntax

__AllParameterSets

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

Beschreibung

Importiert ein X509-Zertifikat. Erfordert als Parameter den zu überschreibenden Zertifikatseintrag und den Pfad zur neuen Zertifikatsdatei. Wenn das neue Zertifikat im Format .pfx vorliegt, erfordert der Befehl zusätzlich das Passwort des Zertifikats. Wenn das neue Zertifikat im Format .pem oder .der vorliegt, erfordert der Befehl zusätzlich den Pfad zur privaten Schlüsseldatei des Zertifikats. Der Benutzer benötigt Hinzufügen- oder Bearbeitungsrechte.

Beispiele

Beispiel 1

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

Importiert ein .pfx-Zertifikat vom angegebenen Pfad unter Verwendung des erforderlichen Passworts (12345) und aktualisiert den X509-Zertifikatseintrag 'MyOtherCert' mit dessen Werten.

Beispiel 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

Importiert ein .pem-Zertifikat vom angegebenen Pfad unter Verwendung des erforderlichen Pfads zum privaten Schlüssel und aktualisiert den X509-Zertifikatseintrag 'MyOtherCert' mit dessen Werten.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

Mit Vorsicht zu verwendender Switch. Er beantwortet automatisch Eingabeaufforderungen, die Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen stellen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die akzeptierten Werte:

• Yes: Akzeptiert die Eingabeaufforderung. Deckt die Werte OK und Automatic ab.
• No: Lehnt die Ja/Nein/Abbrechen-Eingabeaufforderung ab. "Cancel" ist die Rückfalloption, wenn es keine "No"-Option gibt.
• Cancel: Bricht die Ja/Nein/Abbrechen-Eingabeaufforderung ab. "No" ist die Rückfalloption, wenn es keine "Cancel"-Option gibt.

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

Explizit bereitgestelltes PSConnection-Objekt.

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

Passwort für den Zugriff auf das Zertifikat.

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

Zu prüfender Zertifikatsdateipfad.

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

Pfad zur privaten Schlüsseldatei für den Zugriff auf das Zertifikat. Leer lassen, wenn Sie keinen privaten Schlüssel einbeziehen möchten.

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

Tresor, auf den der Befehl angewendet wird. Drei Optionen stehen zur Auswahl:

• Default: Aktuell festgelegter Tresor.
• User: Tresor spezifisch für den aktuellen Benutzer.
• Global: Globaler Tresor der Datenquelle.

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

Zeigt, was geschehen würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

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.

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Import-RDMX509Certificate -detailed". Technische Informationen erhalten Sie mit "Get-Help Import-RDMX509Certificate -full".