Rechte abrufen

Zuweisbare Rechte werden seit DSM 2013.2 als Permission bezeichnet. In diesem Abschnitt wird beschrieben, wie Sie solche Permission-Objekte abrufen.

Hinweis: In älteren Versionen wurden diese Rechte als "Tasks" betitelt. Aus Gründen der Abwärtskompatibilität, werden die Cmdlets für Task-Objekte (wie Get-EmdbTask) ebenfalls noch unterstützt. In einer interaktiven Session wird Ihnen ein Hinweis gegeben, stattdessen jedoch besser das Get-EmdbPersmission Cmdlet zu verwenden.

Beispiele:

Hinweis: Voraussetzung für die Beispiele ist ein verbundenes PowerShell-Laufwerk.

Die Menge der verfügbaren Rechte in DSM 2022.2 lässt sich mit dem Cmdlet Get-EmdbPermission abfragen. Seit DSM 7 sind dies nicht nur die mit dem System standardmäßig gelieferten Rechte, sondern auch die benutzerdefinierten Rechte:

Get-EmdbPermission

Soll die Menge der gelieferten Informationen z. B. auf alle Rechte eingeschränkt werden, deren Name die Zeichenkette 'Manage' enthält, kann der Path-Parameter verwendet werden:

Get-EmdbPermission -Path "*Manage*"

oder alternativ und einfacher

Get-EmdbPermission "*Manage*"

Um alle benutzerdefinierten Rechte abzurufen, also nur solche, die nicht mit DSM 2014.1 als Systemobjekte mitgeliefert werden, verwenden Sie folgendes Kommando:

Get-EmdbPermission | Where-Object {$_.IsSystem -eq $false}

Abrufen des des Rechts "Read" durch Angabe der Item-ID (die ID kann in verschiedenen DSM-Umgebungen variieren):

Get-EmdbPermission -ItemID 1

Tipp: Statt ItemID kann auch der Alias ID verwendet werden.

Hinweis: Beachten Sie, dass Permissions keine Objekte des Kontextes rootDSE sind und sie somit ohne vollqualifizierten bzw. absoluten Pfad zugreifbar sind.

Seit PSX 3.1 gibt es die Möglichkeit beim Abrufen von Berechtigungs-Objekten über den SingleItemExpected-Schalter anzugeben, dass beim Abruf kein oder genau nur ein Objekt erwartet wird. Liefert das Kommando mehr als ein Objekt, so wird eine Fehlermeldung erzeugt, die in Scripts abgefangen und behandelt werden kann.