Set-RDMEntryUsername

Kurzbeschreibung

Legt den Benutzernamen des angegebenen Eintrags fest.

Syntax

Id

Set-RDMEntryUsername [-ID] <guid> [-Username] <string> [-PassThru] [-Refresh] [-Set]
 [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

InputObject

Set-RDMEntryUsername [-InputObject] <PSConnection> [-Username] <string> [-PassThru] [-Refresh]
 [-Set] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Beschreibung

Legt den Benutzernamen des angegebenen Eintrags fest. Um den neuen Benutzernamen dauerhaft zu speichern, muss der Schalter Set verwendet werden. Um den Benutzernamen zu ändern, muss der Benutzer über die entsprechenden Rechte verfügen: „add“ für einen neuen Eintrag und „edit“ für einen bestehenden.

Beispiele

Beispiel 1

PS C:\> $entry = Get-RDMEntry -Name 'EntryA';
    Set-RDMEntryUsername -InputObject $entry -UserName 'newUserName' -Set

Aktualisiert den Benutzernamen des angegebenen Eintrags auf 'newUserName'

Beispiel 2

PS C:\> $securePassword = ConvertTo-SecureString -AsPlainText -String 'newPas$w0rd!';
    Get-RDMEntry -Name 'UniqueName' |
    Set-RDMEntryDomain -Domain 'MyOtherDomain.com' -PassThru |
    Set-RDMEntryPassword -Password $securePassword -PassThru |
    Set-RDMEntryUsername -UserName 'NewUserName' -PassThru |
    Set-RDMEntry

Ändert die Domäne, das Passwort und den Benutzernamen des Eintrags mit dem Namen 'UniqueName'. Die Variable $securePassword ist eine zuvor festgelegte sichere Zeichenfolge. Die Änderung wird mit dem Aufruf von Set-RDMSession dauerhaft gespeichert.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-ForcePromptAnswer

Dieser Schalter ist mit Vorsicht zu verwenden. 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. Folgende Werte werden akzeptiert:

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

-ID

ID des zu ändernden Eintrags. Verwenden Sie den Parameter VaultMode, um im Benutzer-Tresor oder im globalen Tresor zu suchen.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Id
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Gibt den Eintrag an, für den der Benutzername festgelegt werden soll.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: InputObject
  Position: 1
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Gibt den geänderten Eintrag zurück.

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

-Refresh

Sendet eine Aktualisierungsbenachrichtigung an die Remote Desktop Manager-Anwendung. Verwenden Sie den Schalter Set, um die Änderung dauerhaft zu speichern.

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

-Set

Speichert den geänderten Eintrag.

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

-Username

Neuer Benutzername.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  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: Aktuell festgelegter Tresor. - 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: Id
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Zeigt, was geschehen würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- wi
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, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

PSConnection-Objekt des Eintrags, dessen Benutzername geändert werden soll.

Hinweise

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