Set-DSEntryProperty

Sinopsis

Establece una propiedad en una entrada. La entrada no se guarda en el servidor.

Sintaxis

__AllParameterSets

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

Descripción

Establece una propiedad en una entrada y devuelve el objeto modificado. La entrada no se guarda en el servidor; utilice Update-DSEntryBase -FromRDMConnection para conservar los cambios. Este cmdlet permite actualizaciones de propiedades basadas en la canalización, lo que posibilita realizar múltiples modificaciones de propiedades antes de guardar.

Ejemplos

Ejemplo 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

Obtiene una entrada, establece su contraseña y la guarda en el servidor. Esto está destinado a entradas que no son de credenciales; para las entradas de credenciales, consulte el ejemplo siguiente.

Ejemplo 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

Establece la contraseña de una entrada de credenciales.

Ejemplo 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

Establece etiquetas en una entrada utilizando la ruta MetaInformation. Las etiquetas se separan por espacios. Las etiquetas que contienen espacios deben ir entre comillas.

Ejemplo 4

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

Obtiene las entradas cuyo nombre empieza por 'Prod' en todas las bóvedas y establece la etiqueta 'production' en cada una.

Ejemplo 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

Encadena varias actualizaciones de propiedades en una canalización antes de guardar: cambiar el nombre, cambiar el host, mover a una carpeta, establecer su descripción y sus credenciales.

Ejemplo 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

Establece campos personalizados en una entrada. CustomField[1-5]Value almacena texto sin formato, mientras que CustomField[1-5]ValueSensitive cifra automáticamente los valores al guardarlos. Establezca CustomField[1-5]Hidden en true para marcar los campos cifrados como sensibles en la interfaz de usuario.

Ejemplo 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

Convierte un campo personalizado sensible en texto sin formato estableciendo CustomField[1-5]Hidden en false y estableciendo CustomField[1-5]Value. El valor sensible se borra automáticamente.

Parámetros

-Entry

La entrada que se va a modificar.

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

La ruta a la propiedad (por ejemplo, 'MetaInformation'). Déjelo vacío para las propiedades de nivel superior. Este parámetro distingue entre mayúsculas y minúsculas.

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

El nombre de la propiedad que se va a establecer (por ejemplo, 'HostUserName', 'HostPassword', 'Description'). Este parámetro distingue entre mayúsculas y minúsculas.

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

El nuevo valor de la propiedad.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Información de conexión de la entrada.

Salidas

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Notas

Para más información, escriba "Get-Help Set-DSEntryProperty -detailed". Para obtener información técnica, escriba "Get-Help Set-DSEntryProperty -full".