Delen via

Get-SCOMUserRole

  • Referentie
Module:
OperationsManager

Hiermee haalt u gebruikersrollen op.

Syntaxis

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>]

Description

De cmdlet Get-SCOMUserRole haalt gebruikersrollen op. Een gebruikersrol combineert twee elementen:

  • Profiel. Hiermee definieert u de verzameling bewerkingen waartoe de gebruikersrol toegang heeft.
  • Draagwijdte. Definieert de grenzen voor profielbewerkingen; Bijvoorbeeld taken en groepen.

Voorbeelden

Voorbeeld 1: Gebruikersrolgegevens ophalen voor een rol

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

Met deze opdracht wordt de informatie opgehaald voor de gebruikersrol OperationsManagerReadOnlyOperators.

Parameters

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De computer moet de System Center Data Access-service uitvoeren.

Als u deze parameter niet opgeeft, is de standaardwaarde de computer voor de huidige verbinding met de beheergroep.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u een matrix op die de weergavenamen van gebruikersrolobjecten bevat. De cmdlet neemt elke tekenreeks in de matrix en zoekt naar overeenkomsten tussen de weergavenamen van de gebruikersrolobjecten waarmee deze cmdlet werkt. De waarden voor deze parameter variëren, afhankelijk van welke gelokaliseerde management packs worden geïmporteerd in de beheergroep en de landinstelling van de gebruiker waarop Windows PowerShell wordt uitgevoerd.

Type:String[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u een matrix van id's voor gebruikersrolobjecten. De cmdlet gebruikt elke GUID (Globally Unique Identifier) in de matrix en zoekt naar overeenkomsten met de -id eigenschappen van de gebruikersrolobjecten die de cmdlet ophaalt.

Type:Guid[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u een matrix op die de namen van gebruikersrolobjecten bevat. De cmdlet neemt elke tekenreeks in de matrix en zoekt naar overeenkomsten met de Naam eigenschappen van de gebruikersrolobjecten die de cmdlet ophaalt.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Als u Connection-objecten wilt ophalen, geeft u de cmdlet Get-SCOMManagementGroupConnection op.

Als u geen waarde voor deze parameter opgeeft, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False