Add-SCOMUserRole
Lägger till en användarroll i en hanteringsgrupp.
Syntax
Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-Operator]
[-TaskScope <ManagementPackTask[]>]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-ReadOnlyOperator]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-Author]
[-ClassScope <ManagementPackClass[]>]
[-TaskScope <ManagementPackTask[]>]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMUserRole
[-Name] <String>
[[-DisplayName] <String>]
[[-Description] <String>]
[[-Users] <String[]>]
[-AdvancedOperator]
[-TaskScope <ManagementPackTask[]>]
[-GroupScope <MonitoringObjectGroup[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Cmdleten Add-SCOMUserRole lägger till en användarroll i en hanteringsgrupp. En användarroll består av två funktioner:
- 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: Lägg till en ny användarroll för skrivskyddad operatör
PS C:\>Add-SCOMUserRole -Name 'Script Role' -ReadOnlyOperatorDet här kommandot lägger till användarrollen Skrivskyddad operatör med namnet Skriptroll.
Exempel 2: Lägg till en ny användarroll genom att ange användarnamn, uppgifter och grupper
PS C:\>$ApprovedTasks = Get-SCOMTask -Name '*SQL*'
PS C:\> $ApprovedGroups = Get-SCOMGroup -DisplayName '*SQL*'
PS C:\> Add-SCOMUserRole -Name 'SQL Operator' -Operator -GroupScope $ApprovedGroups -TaskScope $ApprovedTasks -User 'Contoso\Katarina','Contoso\Cesar'Det här exemplet lägger till en användarroll baserat på användarnamn, uppgifter och grupper.
De två första kommandona hämtar alla aktivitets- och gruppobjekt som har SQL i sina namn och lagrar objekten i variablerna $ApprovedTasks respektive $ApprovedGroups.
Det sista kommandot skapar en operatoranvändarroll med namnet SQL Operator, som innehåller användarna Katarina och Cesar. Användarrollen ger dessa två användare åtkomst till de uppgifter och grupper som lagras i $ApprovedTasks och $ApprovedGroups.
Parametrar
-AdvancedOperator
Anger att den nya rollen är en avancerad operatör. Den här rollen ger medlemmar möjlighet att åsidosätta konfigurationen av regler och övervakare för specifika mål eller grupper av mål inom det konfigurerade omfånget. Rollen Avancerad operatör ger också alla behörigheter som profilerna Operator och Read-Only Operator beviljar.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Author
Anger att den nya rollen är författare. Den här rollen ger medlemmar möjlighet att skapa, redigera och ta bort övervakningskonfiguration som omfattar uppgifter, regler, övervakare och vyer inom det konfigurerade omfånget. För enkelhetens skull kan en redigeringsroll ha behörigheter för specifika grupper. Rollen Författare ger också alla behörigheter i rollerna Avancerad operator, Operator och Read-Only Operator.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ClassScope
Anger en matris med ManagementPackClass objekt som representerar de klasser som en redigeringsroll har åtkomst till. Om du vill hämta ett ManagementPackClass--objekt använder du cmdleten Get-SCOMClass.
Om du inte anger något värde för den här parametern har rollen åtkomst till alla klasser. Om du vill neka rollen åtkomst till alla klasser anger du $Null eller en tom matris, @().
| Typ: | ManagementPackClass[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-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 |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Credential
Anger ett PSCredential- objekt för hanteringsgruppens anslutning.
Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential.
Om du vill ha mer information 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 |
-Description
Anger en beskrivning av användarrollen. Om du inte anger något värde för den här parametern använder cmdleten värdet för parametern DisplayName.
| Typ: | String |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-DisplayName
Anger visningsnamnet för användarrollen. Om den här parametern inte visas är standardvärdet i parametern Name.
| Typ: | String |
| Position: | 2 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-GroupScope
Anger en matris med MonitoringObjectGroup objekt som representerar de grupper som en användarroll har åtkomst till. Om du vill hämta ett objektgruppsobjekt för övervakning använder du cmdleten Get-MonitoringObjectGroup.
Om du inte anger något värde för den här parametern har rollen åtkomst till alla grupper. Om du vill neka rollen åtkomst till alla grupper anger du $Null eller en tom matris, @()
| Typ: | MonitoringObjectGroup[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Name
Anger namnet på användarrollen.
| Typ: | String |
| Position: | 1 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Operator
Anger att den nya rollen är en operator. Den här rollen ger medlemmar möjlighet att interagera med aviseringar, köra uppgifter och komma åt vyer enligt deras konfigurerade omfång. Rollen Operator ger också alla behörigheter som profilen Read-Only Operator beviljar.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ReadOnlyOperator
Anger att den nya rollen är en Read-Only Operator. Den här rollen ger medlemmarna möjlighet att visa aviseringar och åtkomstvyer enligt deras konfigurerade omfång.
| Typ: | SwitchParameter |
| 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 den här parametern inte visas 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 |
-TaskScope
Anger en matris med ManagementPackTask objekt som representerar de uppgifter som rollen Författare, Operator eller Avancerad operatör har åtkomst till. Om du vill hämta ett ManagementPackTask--objekt använder du cmdleten ManagementPack.GetTask. Om den här parametern inte visas har rollen åtkomst till alla aktiviteter. Om du vill neka rollen Författare, Operator eller Avancerad operatör åtkomst till alla aktiviteter anger du $Null eller en tom matris, @().
| Typ: | ManagementPackTask[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Users
Anger en matris som innehåller namnen på användare som ingår i användarrollen.
| Typ: | String[] |
| Position: | 4 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |