Get-SCOMUserRole
Ruft Benutzerrollen ab.
Syntax
Get-SCOMUserRole
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMUserRole
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMUserRole
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMUserRole
-Name <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Beschreibung
Das Cmdlet Get-SCOMUserRole ruft Benutzerrollen ab. Eine Benutzerrolle kombiniert zwei Elemente:
- Profil. Definiert die Auflistung von Vorgängen, auf die die Benutzerrolle Zugriff hat.
- Umfang. Definiert die Grenzen für Profilvorgänge; Beispielsweise Aufgaben und Gruppen.
Beispiele
Beispiel 1: Abrufen von Benutzerrolleninformationen für eine Rolle
PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"Dieser Befehl ruft die Informationen für die Benutzerrolle "OperationsManagerReadOnlyOperators" ab.
Parameter
-ComputerName
Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.
Der Computer muss den System Center Data Access-Dienst ausführen.
Wenn Sie diesen Parameter nicht angeben, ist der Computer für die aktuelle Verwaltungsgruppenverbindung standardmäßig.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird.
Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Get-Credential-Cmdlet zurückgibt, für diesen Parameter.
Weitere Informationen zu Anmeldeinformationenobjekten geben Sie Get-Help Get-Credentialein.
Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Gibt ein Array an, das die Anzeigenamen von Benutzerrollenobjekten enthält. Das Cmdlet verwendet jede Zeichenfolge im Array und sucht nach Übereinstimmungen zwischen den Anzeigenamen der Benutzerrollenobjekte, die dieses Cmdlet verwendet. Die Werte für diesen Parameter variieren je nachdem, welche lokalisierten Verwaltungspakete in die Verwaltungsgruppe und das Gebietsschema des Benutzers importiert werden, der Windows PowerShell ausgeführt wird.
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Gibt ein Array von IDs für Benutzerrollenobjekte an. Das Cmdlet verwendet jeden global eindeutigen Bezeichner (GUID) im Array und sucht nach Übereinstimmungen mit den ID-Eigenschaften der Benutzerrollenobjekte, die das Cmdlet abruft.
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Gibt ein Array an, das die Namen von Benutzerrollenobjekten enthält. Das Cmdlet verwendet jede Zeichenfolge im Array und sucht nach Übereinstimmungen mit den Eigenschaften der Benutzerrollenobjekte, die das Cmdlet abruft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Um Verbindungsobjekte 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 SCSession-Parameter , um eine andere persistente Verbindung anzugeben.
Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |