Rollen abrufen

Ruft Rollenobjekte ab.

Beispiele:

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

Alle definierten Rollen lassen sich mit dem Cmdlet Get-EmdbRole abfragen.

Get-EmdbRole

Analog zu dem Cmdlet Get-EmdbTask lässt sich die Menge der gelieferten Rollenobjekte einschränken. Im Beispiel wird die Rolle 'Product Manager' angefordert:

Get-EmdbRole -Path "Product Manager"

oder alternativ und einfacher

Get-EmdbRole "Product Manager"

Abrufen der Rolle "Read (System Role)" durch Angabe der Item-ID (die ID kann in verschiedenen DSM-Umgebungen variieren):

Get-EmdbRole -ItemID 6

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

Hinweis: Beachten Sie, dass Rollen 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 Rollen-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.