Get-SCSMUserRole

Referenz

Modul:: System.Center.Service.Manager

Ruft Benutzerrollen ab, die in Service Manager definiert sind.

Syntax

Get-SCSMUserRole
   [[-DisplayName] <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMUserRole
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMUserRole
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCSMUserRole ruft Benutzerrollenprofile ab, die in Service Manager definiert sind. Sie können diese Liste dann verwenden, um Benutzer zu einem der Benutzerrollenprofile hinzuzufügen. Optional können Sie einen regulären Ausdruck angeben, um nach einem bestimmten Benutzerrollenprofil zu suchen.

Beispiele

Beispiel 1: Abrufen der Benutzerrollen für den lokalen Computer

PS C:\>Get-SCSMUserRole
Name                          Description                   LastModified                  LastModifiedBy
----                          -----------                   ------------                  --------------
ChangeManagers                The Service Manager Change... 6/14/2010 5:14:16 AM
IncidentResolvers             The Service Manager Incide... 6/14/2010 5:14:16 AM
ActivityImplementers          The Service Manager Activi... 6/14/2010 5:14:15 AM
Workflows                     The Service Manager Workfl... 6/14/2010 5:14:16 AM
Administrators                The Service Manager Admini... 6/14/2010 5:14:16 AM
ProblemAnalysts               The Service Manager Proble... 6/14/2010 5:14:16 AM
AdvancedOperators             The Service Manager Advanc... 6/14/2010 5:14:16 AM
Authors                       The Service Manager Author... 6/14/2010 5:14:16 AM
ChangeInitiators              The Service Manager Change... 6/14/2010 5:14:16 AM
ReadOnlyOperators             The Service Manager Read-O... 6/14/2010 5:14:16 AM
EndUsers                      The Service Manager End Us... 6/14/2010 5:14:16 AM

Mit diesem Befehl wird die Liste der Benutzerrollen vom lokalen Computer abgerufen.

Beispiel 2: Abrufen der Rolle "Administratoren"

PS C:\>Get-SCSMUserRole -Name "Administrators"
Name                          Description                   LastModified                  LastModifiedBy
----                          -----------                   ------------                  --------------
Administrators                The Service Manager Admini... 6/14/2010 5:14:16 AM

Mit diesem Befehl wird die Benutzerrolle Administratoren abgerufen.

Beispiel 3: Anzeigen der Klassen einer Rolle

PS C:\>$Role = Get-SCSMUserRole -DisplayName "CustomRole"
PS C:\> $Role
DisplayName                   Description                    LastModified                  LastModifiedBy
-----------                   -----------                    ------------                  --------------
CustomRole                    Custom Description             8/6/2010 12:23:46 AM          WOODGROVE\Administrator PS C:\>$Role.Classes
Abstract Name                                                                DisplayName
-------- ----                                                                -----------
True     Microsoft.SystemCenter.ServiceDesigner.Messaging.Storage            Storage
True     Microsoft.SystemCenter.ServiceDesigner.ServiceComponentGroup        Distributed Application Component
False    Microsoft.SystemCenter.StorageDevicesGroup                          Storage Devices Group
True     Microsoft.SystemCenter.ServiceDesigner.WebApplication               Line of Business Web Application
True     Microsoft.SystemCenter.ConfigItemGroup                              All Groups
False    System.WorkItem.Incident                                            Incident
True     Microsoft.SystemCenter.ServiceDesigner.Messaging                    Messaging
True     Microsoft.SystemCenter.InstanceGroup                                All Instance Groups
True     Microsoft.SystemCenter.ServiceDesigner.WebApplication.WebSiteGroup  Web Application Web Sites
True     Microsoft.SystemCenter.ServiceDesigner.WebApplication.DatabaseGroup Web Application Databases
True     Microsoft.SystemCenter.ServiceDesigner.GenericService               Blank
True     Microsoft.SystemCenter.ServiceDesigner.Service                      User Created Distributed Application
False    Microsoft.SystemCenter.BusinessService                              Business Service

Der erste Befehl ruft die Benutzerrolle mit dem Namen CustomRole ab und speichert sie dann in der Variablen $Role.

Der zweite Befehl zeigt den Inhalt $Role an.

Der dritte Befehl zeigt die Klassen von $Role an.

Parameter

-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

-Credential

Gibt die Anmeldeinformationen an, die dieses Cmdlet verwendet, um eine Verbindung mit dem Server herzustellen, auf dem der System Center-Datenzugriffsdienst 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

-DisplayName

Gibt den Anzeigenamen der abzurufenden Benutzerrolle an. Sie können einen regulären Ausdruck angeben.

Typ:	System.String[]
Position:	0
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Id

Gibt die ID der Benutzerrolle an, die abgerufen werden soll.

Typ:	System.Guid[]
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Gibt den Namen der Benutzerrolle an, die abgerufen werden soll. Sie können einen regulären Ausdruck angeben.

Typ:	System.String[]
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SCSession

Gibt ein Objekt an, das eine Sitzung mit einem Service Manager-Verwaltungsserver darstellt.

Typ:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

System.String

Sie können einen Namen über die Pipeline an den DisplayName-Parameter übergeben.

System.Guid

Sie können eine GUID über die Pipeline an den Id-Parameter übergeben.

Ausgaben

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Das UserRole-Objekt stellt die Informationen zu den Service Manager-Benutzerrollen bereit. Dieses Objekt kann in Verbindung mit dem Cmdlet Update-SCSMUserRole verwendet werden, um einer Benutzerrolle einen Benutzer hinzuzufügen.

Freigeben über