New-RDMEntry

Übersicht

Einen neuen Eintrag erstellen.

Syntax

__AllParameterSets

New-RDMEntry [[-Name] <string>] [-Type] <ConnectionType> [[-Group] <string>] [[-Host] <string>]
 [[-TemplateID] <guid>] [-DocumentAttachment <PSConnectionAttachment>] [-DocumentFileName <string>]
 [-Set] [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Beschreibung

Einen neuen Eintrag erstellen. Um den neuen Eintrag zu speichern, muss der Schalter SetSession verwendet werden. Um im Benutzer-Tresor oder im System-Tresor zu speichern, verwenden Sie den Parameter VaultMode.

Beispiele

Beispiel 1

PS C:\> New-RDMEntry -Name 'New Entry' -Host 'myServer' -Type 'RDPConfigured' -Set -VaultMode User

Einen neuen Eintrag im Benutzer-Tresor erstellen und speichern.

Beispiel 2

PS C:\> $folder = New-RDMEntry -Name 'New Folder' -Type 'Group';
        $folder.GroupDetails.UserName = 'MyUserName';
        $folder.GroupDetails.Domain = 'MyDomain';
        Set-RDMEntry -InputObject $folder

Einen neuen Eintrag erstellen, ohne ihn zu speichern, und in $folder ablegen. Einige zusätzliche Informationen in den GroupDetails hinzufügen. Den Eintrag im aktuellen Tresor speichern.

Parameter

-DocumentAttachment

Neuer Dokumentanhang.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnectionAttachment
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-DocumentFileName

Neuer Dokumentdateiname.

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

Schalter, der mit Vorsicht zu verwenden ist. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die akzeptierten Werte:

• Yes: Die Eingabeaufforderung annehmen. Deckt den Wert OK und Automatic ab.
• No: Die Ja/Nein/Abbrechen-Eingabeaufforderung ablehnen. Cancel ist die Ausweichoption, wenn es keine Option No gibt.
• Cancel: Die Ja/Nein/Abbrechen-Eingabeaufforderung abbrechen. No ist die Ausweichoption, wenn es keine Option Cancel 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: ''

-Group

Ordner, in dem sich der Eintrag befinden wird. Er entspricht der Eigenschaft 'Group' des PSConnection-Objekts.

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

-Host

Host des Eintrags. Wert nur für bestimmte Eintragstypen verfügbar.

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

-Name

Name des Eintrags. Er darf nicht leer sein. Wenn der Parameter Host jedoch nicht leer ist, wird er als Ausweichoption verwendet.

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

-Set

Den Eintrag basierend auf dem Tresormodus speichern: - Default => Im aktuellen Tresor - User => Im Benutzer-Tresor - Global => Im System-Tresor

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: ''

-TemplateID

ID der Vorlage, die zum Erstellen des Eintrags verwendet wird. Sie ist für Einträge des Typs 'TemplateGroup' erforderlich.

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

-Type

Typ des zu erstellenden Eintrags.

Type: Devolutions.RemoteDesktopManager.ConnectionType
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-VaultMode

Tresor, auf den der Befehl angewendet wird. Es werden drei Optionen angeboten:

• Default: Aktueller Tresor, der festgelegt wurde.
• User: Tresor, der für den aktuellen Benutzer spezifisch ist.
• 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: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Hinweise

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