Freigeben über


Get-SCOMUserRole

Ruft Benutzerrollen ab.

Syntax

Empty (Standardwert)

Get-SCOMUserRole
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleDisplayName

Get-SCOMUserRole
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleId

Get-SCOMUserRole
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleName

Get-SCOMUserRole
    -Name <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Get-SCOMUserRole werden Benutzerrollen abgerufen. Eine Benutzerrolle kombiniert zwei Elemente:

  • Profil. Definiert die Auflistung der Vorgänge, auf die die Benutzerrolle Zugriff hat.
  • Bereich. Definiert die Grenzen für Profiloperationen. Zum Beispiel Aufgaben und Gruppen.

Beispiele

Beispiel 1: Abrufen von Benutzerrolleninformationen für eine Rolle

PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"

Mit diesem Befehl werden die Informationen für die Benutzerrolle mit dem Namen OperationsManagerReadOnlyOperators abgerufen.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (Fully Qualified Domain Names, FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.

Der Computer muss den System Center Data Access-Dienst ausführen.

Wenn Sie diesen Parameter nicht angeben, ist der Standardwert der Computer für die aktuelle Verwaltungsgruppenverbindung.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Credential

Gibt das Benutzerkonto an, unter dem die Verbindung mit der Verwaltungsgruppe ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential-Objekt an, z. B. ein Objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Weitere Informationen zu Objekten mit Anmeldeinformationen erhalten Sie, wenn Sie Get-Help Get-Credential.

Wenn Sie im Parameter ComputerName einen Computer angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt ein Array an, das die Anzeigenamen von Benutzerrollenobjekten enthält. Das Cmdlet verwendet jede Zeichenfolge im Array und sucht nach Übereinstimmungen unter den Anzeigenamen der Benutzerrollenobjekte, mit denen dieses Cmdlet arbeitet. Die Werte für diesen Parameter variieren je nachdem, welche lokalisierten Management Packs in die Verwaltungsgruppe importiert werden, und vom Gebietsschema des Benutzers, der Windows PowerShell ausführt.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromUserRoleDisplayName
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt ein Array von IDs für Benutzerrollenobjekte an. Das Cmdlet verwendet jede GUID (Globally Unique Identifier) im Array und sucht nach Übereinstimmungen mit den ID-Eigenschaften der Benutzerrollenobjekte, die das Cmdlet abruft.

Parametereigenschaften

Typ:

Guid[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromUserRoleId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt ein Array an, das die Namen der Benutzerrollenobjekte enthält. Das Cmdlet verwendet jede Zeichenfolge im Array und sucht nach Übereinstimmungen mit den Name-Eigenschaften der Benutzerrollenobjekte, die das Cmdlet abruft.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromUserRoleName
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SCSession

Gibt ein Array von Connection-Objekten an. Um Connection-Objekte abzurufen, geben Sie das cmdlet Get-SCOMManagementGroupConnection an.

Wenn Sie keinen Wert für diesen Parameter angeben, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den Parameter SCSession , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Credential verwenden. Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.

Parametereigenschaften

Typ:

Connection[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.