Freigeben über


New-SCSMUserRole

Erstellt eine neue Benutzerrolle im Dienst-Manager.

Syntax

Default (Standardwert)

New-SCSMUserRole
    [-UserRoleType] <UserRoleTypeEnum>
    -DisplayName <String>
    [-Description <String>]
    [-Class <ManagementPackClass[]>]
    [-Group <EnterpriseManagementObject[]>]
    [-CatalogGroup <EnterpriseManagementObject[]>]
    [-Queue <EnterpriseManagementObject[]>]
    [-Task <ManagementPackConsoleTask[]>]
    [-View <ManagementPackView[]>]
    [-FormTemplate <ManagementPackObjectTemplate[]>]
    [-User <String[]>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCSMUserRole erstellt eine Benutzerrolle im Dienst-Manager.

Beispiele

Beispiel 1: Erstellen einer Benutzerrolle mit allen Zugriffen

PS C:\>New-SCSMUserRole -UserRoleType ActivityImplementer -DisplayName "Role for implementers" -User "WOODGROVE\Domain Admins"

Mit diesem Befehl wird eine Benutzerrolle erstellt, die Zugriff auf alle Management Packs, Warteschlangen, Gruppen, Aufgaben, Ansichten und Vorlagen hat. Die Mitglieder der Benutzerrolle sind Domänenadministratoren.

Beispiel 2: Erstellen einer schreibgeschützten Rolle für Formulare und Ansichten

PS C:\>New-SCSMUserRole -UserRoleType ReadOnlyOperator -DisplayName "restricted role" -Group @() -Queue @() -Task @() -User "WOODGROVE\Patti Fuller"

Mit diesem Befehl wird eine schreibgeschützte Operatorrolle erstellt, die nur Zugriff auf Formulare und Ansichten hat. Das einzige Mitglied in der neuen Rolle ist Patti Fuller.

Parameter

-CatalogGroup

Gibt die Katalogelementgruppen an, die Mitgliedern dieser Benutzerrolle zur Verfügung stehen, um den Zugriff auf nur bestimmte Gruppen von Katalogelementen zu beschränken. Katalogelemente in nicht angegebenen Gruppen sind für Mitglieder in dieser Rolle nicht verfügbar.

Geben Sie "Alle" an, um den Zugriff auf alle Gruppen zuzulassen. Wenn Sie keinen Wert angeben, sind keine Katalogelementgruppen verfügbar.

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]

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

-Class

Gibt die Instanzen von Management Pack-Klassen an, auf die die Benutzerrolle Zugriff hat. Dies gilt nur für die Rolle "Autor".

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]

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

-ComputerName

Gibt den Namen des Computers an, auf dem der System Center Data Access-Dienst ausgeführt wird. Das benutzerkonto, das im parameter Credential angegeben ist, muss über Zugriffsrechte für den angegebenen Computer verfügen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:Localhost
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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

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 die Anmeldeinformationen an, die dieses Cmdlet zum Herstellen einer Verbindung mit dem Server verwendet, auf dem der System Center Data Access-Dienst ausgeführt wird. Das angegebene Benutzerkonto muss über Zugriffsrechte für diesen Server verfügen.

Parametereigenschaften

Typ:System.Management.Automation.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

-Description

Gibt eine Beschreibung für die Benutzerrolle an.

Parametereigenschaften

Typ:System.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

-DisplayName

Gibt den Namen der Benutzerrolle an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FormTemplate

Gibt die Formularvorlagen an, die den Benutzern in dieser Benutzerrolle zur Verfügung stehen. Nicht angegebene Formulare stehen Benutzern in dieser Rolle nicht zur Verfügung. Geben Sie 'Keine' an, um keine Vorlagen zur Verfügung zu stellen. Geben Sie alle an, um alle Vorlagen verfügbar zu machen.

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[]

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

-Group

Gibt die Gruppen an, die Mitgliedern dieser Benutzerrolle zur Verfügung stehen, um den Zugriff auf nur bestimmte Gruppen von Konfigurationselementen zu beschränken. Konfigurationselemente in nicht angegebenen Gruppen sind für Mitglieder in dieser Rolle nicht verfügbar. Geben Sie "Alle" an, um den Zugriff auf alle Gruppen zuzulassen. Wenn Sie keinen Wert angeben, sind keine Gruppen verfügbar.

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]

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

-PassThru

Gibt an, dass dieses Cmdlet die von ihr erstellten Benutzerrolle zurückgibt. Sie können dieses Objekt an andere Cmdlets übergeben.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
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

-Queue

Gibt die Warteschlangen an, die Mitgliedern dieser Benutzerrolle zur Verfügung stehen, um den Zugriff auf nur bestimmte Warteschlangen von Arbeitsaufgaben zu beschränken. Arbeitsaufgaben in nicht angegebenen Warteschlangen sind für Mitglieder in dieser Benutzerrolle nicht verfügbar. Geben Sie "Alle" an, um den Zugriff auf alle Warteschlangen zuzulassen. Wenn Sie keinen Wert angeben, sind keine Warteschlangen verfügbar.

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]

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

-SCSession

Gibt ein Objekt an, das eine Sitzung auf einem Dienst-Manager-Verwaltungsserver darstellt.

Parametereigenschaften

Typ:

Microsoft.SystemCenter.Core.Connection.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

-Task

Gibt eine Verwaltungspaket-Konsolenaufgabe an. Geben Sie diesen Parameter nur an, wenn die eigenschaft ManagementPack nicht $Null ist. Der Wert "All" bedeutet, dass auf alle Elemente zugegriffen werden kann, und der Wert "None" bedeutet, dass keine Elemente zugänglich sind.

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[]

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

-User

Gibt die Benutzer an, die Mitglieder der neuen Benutzerrolle sind.

Parametereigenschaften

Typ:

System.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

-UserRoleType

Gibt den Typ der zu erstellenden Benutzerrolle an. Gültige Werte sind:

  • AktivitätImplementierer
  • Administratoren
  • Fortgeschrittene Operatoren
  • Autoren
  • Change-Initiatoren
  • Veränderer
  • Endbenutzer
  • Störungslöser
  • ProblemAnalysten
  • ReadOnlyOperatoren
  • Arbeitsabläufe

Parametereigenschaften

Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum
Standardwert:None
Zulässige Werte:ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-View

Gibt die Ansichten an, die Mitgliedern dieser Benutzerrolle zur Verfügung stehen, um den Zugriff auf nur bestimmte Ansichten zu beschränken. Nicht angegebene Ansichten sind für Mitglieder in dieser Rolle nicht verfügbar. Geben Sie "Alle" an, um den Zugriff auf alle Ansichten zuzulassen. Wenn Sie keinen Wert angeben, sind keine Ansichten verfügbar.

Parametereigenschaften

Typ:

Microsoft.EnterpriseManagement.Configuration.ManagementPackView[]

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

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.

Eingaben

None.

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

None.

Dieses Cmdlet generiert keine Ausgabe.