Set-DSEntryProperty

Kurzbeschreibung

Legt eine Eigenschaft für einen Eintrag fest. Der Eintrag wird nicht auf dem Server gespeichert.

Syntax

__AllParameterSets

Set-DSEntryProperty [-Entry] <ConnectionInfoEntity> [[-Path] <string>] [-PropertyName] <string>
 [-PropertyValue] <Object> [<CommonParameters>]

Beschreibung

Legt eine Eigenschaft für einen Eintrag fest und gibt das geänderte Objekt zurück. Der Eintrag wird nicht auf dem Server gespeichert; verwenden Sie Update-DSEntryBase -FromRDMConnection, um Änderungen zu speichern. Dieses Cmdlet ermöglicht Pipeline-basierte Eigenschaftsaktualisierungen, sodass mehrere Eigenschaftsänderungen vor dem Speichern vorgenommen werden können.

Beispiele

Beispiel 1

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo | Set-DSEntryProperty -PropertyName "HostPassword" -PropertyValue "MyNewPassword" | Update-DSEntryBase

Einen Eintrag abrufen, dessen Passwort festlegen und ihn auf dem Server speichern. Dies ist für Einträge ohne Anmeldeinformationen vorgesehen; für Einträge mit Anmeldeinformationen siehe das folgende Beispiel.

Beispiel 2

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo | Set-DSEntryProperty -Path "Credentials" -PropertyName "Password" -PropertyValue "MyNewPassword" | Update-DSEntryBase

Das Passwort eines Anmeldeinformationseintrags festlegen.

Beispiel 3

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo | Set-DSEntryProperty -Path "MetaInformation" -PropertyName "Keywords" -PropertyValue "production web-server critical" | Update-DSEntryBase

Tags für einen Eintrag über den Pfad MetaInformation festlegen. Tags werden durch Leerzeichen getrennt. Tags, die Leerzeichen enthalten, sollten in Anführungszeichen gesetzt werden.

Beispiel 4

PS C:\> Get-DSEntry -FilterBy Name -FilterMatch StartsWith -FilterValue "Prod" -SearchAllVaults |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "Keywords" -PropertyValue "production" |
    Update-DSEntryBase

Einträge, deren Name mit 'Prod' beginnt, über alle Tresore hinweg abrufen und für jeden das Tag 'production' festlegen.

Beispiel 5

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo |
    Set-DSEntryProperty -PropertyName "Name" -PropertyValue "Production Server" |
    Set-DSEntryProperty -PropertyName "Host" -PropertyValue "server.windjammer.loc" |
    Set-DSEntryProperty -PropertyName "Group" -PropertyValue "Production\Servers\Web" |
    Set-DSEntryProperty -PropertyName "Description" -PropertyValue "Production web server" |
    Set-DSEntryProperty -PropertyName "HostUserName" -PropertyValue "admin" |
    Set-DSEntryProperty -PropertyName "HostDomain" -PropertyValue "WINDJAMMER" |
    Set-DSEntryProperty -PropertyName "HostPassword" -PropertyValue "SecurePass123" |
    Update-DSEntryBase

Mehrere Eigenschaftsaktualisierungen in einer Pipeline vor dem Speichern verketten: umbenennen, Host ändern, in Ordner verschieben, Beschreibung und Anmeldeinformationen festlegen.

Beispiel 6

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Title" -PropertyValue "Department" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Value" -PropertyValue "Engineering" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField2Title" -PropertyValue "API Key" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField2ValueSensitive" -PropertyValue "sk-abc123def456" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField2Hidden" -PropertyValue $true |
    Update-DSEntryBase

Benutzerdefinierte Felder für einen Eintrag festlegen. CustomField[1-5]Value speichert Klartext, während CustomField[1-5]ValueSensitive Werte beim Speichern automatisch verschlüsselt. Setzen Sie CustomField[1-5]Hidden auf true, um verschlüsselte Felder in der Benutzeroberfläche als sensibel zu markieren.

Beispiel 7

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Hidden" -PropertyValue $false |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Value" -PropertyValue "plain text value" |
    Update-DSEntryBase

Ein sensibles benutzerdefiniertes Feld in Klartext umwandeln, indem CustomField[1-5]Hidden auf false gesetzt und CustomField[1-5]Value festgelegt wird. Der sensible Wert wird automatisch gelöscht.

Parameter

-Entry

Der zu ändernde Eintrag.

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

-Path

Der Pfad zur Eigenschaft (z. B. 'MetaInformation'). Für Eigenschaften der obersten Ebene leer lassen. Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden.

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

-PropertyName

Der Name der festzulegenden Eigenschaft (z. B. 'HostUserName', 'HostPassword', 'Description'). Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden.

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

-PropertyValue

Der neue Wert für die Eigenschaft.

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

Eingaben

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Verbindungsinformationen des Eintrags.

Ausgaben

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Set-DSEntryProperty -detailed". Technische Informationen erhalten Sie mit "Get-Help Set-DSEntryProperty -full".