Set-DSEntryProperty

Sintesi

Imposta una proprietà su una voce. La voce non viene salvata sul server.

Sintassi

__AllParameterSets

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

Descrizione

Imposta una proprietà su una voce e restituisce l'oggetto modificato. La voce non viene salvata sul server; utilizzi Update-DSEntryBase -FromRDMConnection per rendere persistenti le modifiche. Questo cmdlet consente aggiornamenti delle proprietà basati sulla pipeline, permettendo più modifiche di proprietà prima del salvataggio.

Esempi

Esempio 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

Ottiene una voce, ne imposta la password e la salva sul server. Questo è destinato alle voci non di tipo credenziale; per le voci di tipo credenziale, veda l'esempio seguente.

Esempio 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

Imposta la password di una voce di tipo credenziale.

Esempio 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

Imposta i tag su una voce utilizzando il percorso MetaInformation. I tag sono separati da spazi. I tag che contengono spazi devono essere racchiusi tra virgolette.

Esempio 4

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

Ottiene le voci il cui nome inizia con 'Prod' in tutte le casseforti e imposta il tag 'production' su ciascuna.

Esempio 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

Concatena più aggiornamenti di proprietà in una pipeline prima del salvataggio: rinomina, cambia host, sposta in una cartella, imposta la descrizione e le credenziali.

Esempio 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

Imposta i campi personalizzati su una voce. CustomField[1-5]Value memorizza testo normale, mentre CustomField[1-5]ValueSensitive cifra automaticamente i valori al momento del salvataggio. Imposti CustomField[1-5]Hidden su true per contrassegnare i campi cifrati come sensibili nell'interfaccia utente.

Esempio 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

Converte un campo personalizzato sensibile in testo normale impostando CustomField[1-5]Hidden su false e impostando CustomField[1-5]Value. Il valore sensibile viene cancellato automaticamente.

Parametri

-Entry

La voce da modificare.

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

Il percorso della proprietà (ad esempio, 'MetaInformation'). Lo lasci vuoto per le proprietà di primo livello. Questo parametro fa distinzione tra maiuscole e minuscole.

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

Il nome della proprietà da impostare (ad esempio, 'HostUserName', 'HostPassword', 'Description'). Questo parametro fa distinzione tra maiuscole e minuscole.

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

Il nuovo valore della proprietà.

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

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per maggiori informazioni, veda about_CommonParameters.

Input

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Informazioni sulla connessione della voce.

Output

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Note

Per maggiori informazioni, digiti "Get-Help Set-DSEntryProperty -detailed". Per informazioni tecniche, digiti "Get-Help Set-DSEntryProperty -full".