Dela via


Get-SCOMUserRole

Hämtar användarroller.

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

Description

Cmdleten Get-SCOMUserRole hämtar användarroller. En användarroll kombinerar två element:

  • Profil. Definierar den samling åtgärder som användarrollen har åtkomst till.
  • Omfattning. Definierar gränserna för profilåtgärder. till exempel uppgifter och grupper.

Exempel

Exempel 1: Hämta information om användarroller för en roll

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

Det här kommandot hämtar information om användarrollen med namnet OperationsManagerReadOnlyOperators.

Parametrar

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

Datorn måste köra System Center Data Access-tjänsten.

Om du inte anger den här parametern är standardinställningen datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger det användarkonto under vilket anslutningen till hanteringsgruppen körs. Ange ett PSCredential- objekt, till exempel ett objekt som cmdleten Get-Credential returnerar för den här parametern. Om du vill ha mer information om autentiseringsobjekt skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger en matris som innehåller visningsnamnen för användarrollobjekt. Cmdleten tar varje sträng i matrisen och söker efter matchningar mellan visningsnamnen för användarrollobjekten som den här cmdleten fungerar med. Värdena för den här parametern varierar beroende på vilka lokaliserade hanteringspaket som importeras till hanteringsgruppen och språkvarianten för den användare som kör Windows PowerShell.

Typ:String[]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger en matris med ID:er för användarrollobjekt. Cmdleten tar varje globalt unik identifierare (GUID) i matrisen och söker efter matchningar med -ID egenskaper för användarrollobjekten som cmdleten får.

Typ:Guid[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger en matris som innehåller namnen på användarrollobjekt. Cmdleten tar varje sträng i matrisen och söker efter matchningar med egenskaperna Namn för användarrollobjekten som cmdleten får.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta anslutningsobjekt anger du cmdleten Get-SCOMManagementGroupConnection.

Om du inte anger något värde för den här parametern använder cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False