New-SCSMUserRole
Erstellt eine neue Benutzerrolle im Dienst-Manager.
Syntax
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.
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Class
Gibt die Instanzen von Management Pack-Klassen an, auf die die Benutzerrolle Zugriff hat. Dies gilt nur für die Rolle "Autor".
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | System.String[] |
| Position: | Named |
| Standardwert: | Localhost |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | System.Management.Automation.SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | System.Management.Automation.PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die Benutzerrolle an.
| Typ: | System.String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisplayName
Gibt den Namen der Benutzerrolle an.
| Typ: | System.String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt an, dass dieses Cmdlet die von ihr erstellten Benutzerrolle zurückgibt. Sie können dieses Objekt an andere Cmdlets übergeben.
| Typ: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SCSession
Gibt ein Objekt an, das eine Sitzung auf einem Dienst-Manager-Verwaltungsserver darstellt.
| Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-User
Gibt die Benutzer an, die Mitglieder der neuen Benutzerrolle sind.
| Typ: | System.String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserRoleType
Gibt den Typ der zu erstellenden Benutzerrolle an. Gültige Werte sind:
- ActivityImplementers
- Administratoren
- AdvancedOperators
- Autoren
- ChangeInitiators
- ChangeManagers
- EndUsers
- IncidentResolvers
- ProblemAnalysts
- ReadOnlyOperators
- Workflows
| Typ: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum |
| Zulässige Werte: | ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | System.Management.Automation.SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None.
Sie können keine Eingabe an dieses Cmdlet weiterleiten.
Ausgaben
None.
Dieses Cmdlet generiert keine Ausgabe.