Set-RDMSessionProperty

Übersicht

Setzt den Wert einer Eigenschaft anhand einer Sitzungs-ID und eines Pfads.

Syntax

__AllParameterSets

Set-RDMSessionProperty [-ID] <guid> [[-Path] <string>] [-Property] <string> [-Value] <Object>
 [-Refresh] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Beschreibung

Geschützte Werte geben immer null zurück.

Nicht-Werttypen geben immer ".ToString()" zurück.

Beispiele

Beispiel 1

PS C:\> Set-RDMSessionProperty -ID "{00000000-0000-0000-0000-000000000000}" -Property "Group" -Value "My New Group Name"

Setzt den Wert Group der Sitzung mit ID = "{00000000-0000-0000-0000-000000000000}".

Beispiel 2

PS C:\> Set-RDMSessionProperty "{00000000-0000-0000-0000-000000000000}" "MetaInformation" "OS" "Windows Server 2008 R2"

Setzt den Wert MetaInformation.OS der Sitzung mit ID = "{00000000-0000-0000-0000-000000000000}".

Beispiel 3

PS C:\> $list = Get-RDMSession; Set-RDMSessionProperty -ID $list[1].ID -Path "MetaInformation" -Property "OS" -Value "Windows Server 2008 R2"

Ruft die Liste der verfügbaren Sitzungen ab und setzt anschließend den Wert MetaInformation.OS des zweiten Elements in der Liste.

Parameter

-ForcePromptAnswer

Mit Vorsicht zu verwendender Schalter. 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 zulässigen Werte:

• Yes: Die Eingabeaufforderung annehmen. Deckt die Werte 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: ''

-ID

Gibt die ID der Sitzung an, von der das Passwort abgerufen werden soll.

Muss eine gültige GUID in der Form {00000000-0000-0000-0000-000000000000} sein.

Type: System.Guid
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 gelesenen Eigenschaft (siehe RDM-Export-XML). Bei einer Eigenschaft der obersten Ebene den Parameter nicht angeben oder eine leere Zeichenfolge [""] bzw. $null übergeben.

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

-Property

Zu setzende Eigenschaft.

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

-Refresh

Sendet eine Aktualisierungsbenachrichtigung an die Remote Desktop Manager-Anwendung.

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

-Value

Neuer Wert.

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.

Hinweise

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