Import-RDMRepository

Synopsis

Importiert die in einer rdx-Datei enthaltenen Tresore in die aktuelle Datenquelle.

Syntax

__AllParameterSets

Import-RDMRepository [-Path] <string> [-Password <securestring>] [-Duplicate <DuplicateAction>]
 [-KeepID] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Beschreibung

Importiert die in einer rdx-Datei enthaltenen Tresore in die aktuelle Datenquelle. Wenn die Datei geschützt ist, muss der Parameter Password verwendet werden, um die enthaltenen Daten zu entsperren. Standardmäßig wird die ID aller Einträge geändert. Damit werden unerwünschte Verhaltensweisen vermieden, wie zum Beispiel das Verschieben eines Eintrags, wenn er in dieselbe Datenbank importiert wird. Der Parameter Duplicate gibt die Aktion (ignore, overwrite, add) an, die bei doppelten Einträgen angewendet wird. Eine Einschränkung des Befehls ist die fehlende Möglichkeit, die importierten Tresore einem bestimmten Tresor zuzuordnen. Jeder Tresor wird einem vorhandenen Tresor mit derselben ID oder demselben Namen zugewiesen, oder einem neuen Tresor, wenn keiner gefunden wird. Dieser Befehl steht nur Administratoren auf erweiterten Datenquellen zur Verfügung. Da eine Anwendungsidentität auf einer Devolutions Cloud-Datenquelle keine Administratorrechte besitzen kann, sind ihre Möglichkeiten stärker eingeschränkt. Sie muss über die entsprechenden Rechte verfügen (Einträge hinzufügen, Tresor erstellen).

Beispiele

Beispiel 1

PS C:\> $pwd = Read-Host -AsSecureString;
    Import-RDMRepository -Path myFile.rdx -Password $pwd

Importiert alle Tresore in 'myFile.rdx'. Die geschützte Datei wird mit dem Parameter $pwd entsperrt.

Beispiel 2

PS C:\> $filePath = 'C:\my\path\filename.rdx';
    Export-RDMRepository -Name VaultA, VaultB, VaultC -Path $path -IncludeAttachments -IncludeCredentials -IncludeDocumentation;
    Get-RDMDataSource -Name AnotherOne | Set-RDMCurrentDataSource;
    Import-RDMSession -Path myFile.rdx -KeepID -Duplicate IgnoreAll

Exportiert VaultA, VaultB und VaultC der aktuellen Datenquelle in die durch $path angegebene Datei. Ändert die aktuelle Datenquelle zu 'AnotherOne' und importiert alle kürzlich exportierten Tresore. Wenn der Schalter KeepID vorhanden ist, behalten alle importierten Einträge ihre ID. Solange die neue Datenquelle nicht dieselbe Datenbank verwendet, treten keine unerwarteten Verhaltensweisen auf.

Parameter

-Duplicate

Aktion, die bei einem Duplikat auf die importierten Einträge angewendet wird. Wenn der Schalter KeepID nicht vorhanden ist, werden keine Duplikate gefunden. Standardmäßig werden alle Duplikate ignoriert.

Type: Devolutions.RemoteDesktopManager.DuplicateAction
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, die Fragen mit yes/no, yes/no/cancel oder ok/cancel stellen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Dies sind die zulässigen Werte:

• Yes: Akzeptiert die Eingabeaufforderung. Deckt die Werte OK und Automatic ab.
• No: Lehnt die yes/no/cancel-Eingabeaufforderung ab. "Cancel" ist die Ersatzoption, wenn keine "No"-Option vorhanden ist.
• Cancel: Bricht die yes/no/cancel-Eingabeaufforderung ab. "No" ist die Ersatzoption, 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: ''

-KeepID

Behält die ID aller importierten Verbindungen. Dies kann unerwünschte Verhaltensweisen verursachen, wie zum Beispiel das Verschieben eines Eintrags, wenn er in dieselbe Datenbank importiert wird.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Password

Entsperrt die in der geschützten Datei enthaltenen Daten.

Type: System.Security.SecureString
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Pfad, in dem die Datei mit den exportierten Tresoren gespeichert wird. Die Erweiterung muss '.rdx' sein.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  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

Für weitere Informationen geben Sie "Get-Help Import-RDMRepository -detailed" ein. Für technische Informationen geben Sie "Get-Help Import-RDMRepository -full" ein.