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.