Set-RDMEntryTags

Übersicht

Tags eines Eintrags festlegen

Syntax

ID

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

InputObject

Set-RDMEntryTags [-InputObject] <PSConnection> [-Tags] <string[]> [-PassThru] [-Refresh] [-Set]
 [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Beschreibung

Legt die Tags des angegebenen Eintrags aus einem Array fest. Dies ersetzt alle vorhandenen Tags des Eintrags (geerbte Tags bleiben unberührt). Um die neuen Tags zu speichern, wenn der Parametersatz InputObject verwendet wird, muss der Schalter Set verwendet werden. Bei Verwendung des Parametersatzes ID wird der Eintrag automatisch gespeichert. Der Benutzer muss das Recht haben, den Eintrag zu bearbeiten. Die Tagvererbung kann auf Tresorebene aktiviert werden, indem das Stammverbindungsobjekt geändert wird.

Beispiele

Beispiel 1

PS C:\> Set-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}" -Tags @("Production", "Database", "Critical")

Tags eines Eintrags anhand seiner ID festlegen.

Beispiel 2

PS C:\> $entry = Get-RDMEntry -Name 'MyEntry';
PS C:\> Set-RDMEntryTags -InputObject $entry -Tags @("Production", "Database", "Critical") -Set

Tags eines Eintrags mit InputObject festlegen und die Änderungen speichern.

Beispiel 3

PS C:\> Get-RDMEntry -Name "MyEntry" | Set-RDMEntryTags -Tags @("Production", "Database") -PassThru

Pipelineverwendung mit InputObject und PassThru, um den geänderten Eintrag zurückzugeben.

Beispiel 4

PS C:\> Set-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}" -Tags @()

Alle Tags eines Eintrags entfernen.

Beispiel 5

PS C:\> $tags = Get-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}"
PS C:\> $tags += "NewTag"
PS C:\> Set-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}" -Tags $tags

Tags eines Eintrags abrufen, ändern und festlegen.

Beispiel 6

PS C:\> Get-RDMEntry -Name "MyEntry" |
Set-RDMEntryTags -Tags @("Production", "Database") -PassThru |
Set-RDMEntryDomain -Domain "MyDomain.com" -PassThru |
Set-RDMEntry

Mehrere Änderungen über PassThru verketten und mit Set-RDMEntry speichern.

Parameter

-Confirm

Fordert vor der Ausführung des Cmdlets eine Bestätigung an.

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

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

Gibt die ID des Eintrags an, für den Tags festgelegt werden. Muss eine gültige GUID der Form {00000000-0000-0000-0000-000000000000} sein.

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, dessen Tags festgelegt werden.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: InputObject
  Position: 0
  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

Einträge im Tresor aktualisieren. Den Schalter Set verwenden, um die Änderung zu speichern. Für eine Massenänderung Update-RDMEntries nach den Änderungen verwenden, anstatt dieses Schalters.

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

-Tags

Array von Tags, die für den Eintrag festgelegt werden. Ein leeres Array übergeben, um alle Tags zu entfernen.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt würde. 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 Tags festgelegt werden.

Ausgaben

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

Der Eintrag mit den neu zugewiesenen Tags wird zurückgegeben, wenn PassThru verwendet wird.

Hinweise

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