Get-SCSMUserRole
Hiermee worden gebruikersrollen opgehaald die in Service Manager zijn gedefinieerd.
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>]
Description
Met de cmdlet Get-SCSMUserRole worden gebruikersrolprofielen opgehaald die zijn gedefinieerd in Service Manager. Vervolgens kunt u deze lijst gebruiken om gebruikers toe te voegen aan een van de gebruikersrolprofielen. U kunt desgewenst een reguliere expressie opgeven om te zoeken naar een specifiek gebruikersrolprofiel.
Voorbeelden
Voorbeeld 1: De gebruikersrollen voor de lokale computer ophalen
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
Met deze opdracht wordt de lijst met gebruikersrollen opgehaald van de lokale computer.
Voorbeeld 2: de rol Administrators ophalen
PS C:\>Get-SCSMUserRole -Name "Administrators"
Name Description LastModified LastModifiedBy
---- ----------- ------------ --------------
Administrators The Service Manager Admini... 6/14/2010 5:14:16 AM
Met deze opdracht wordt de gebruikersrol Administrators opgehaald.
Voorbeeld 3: De klassen van een rol weergeven
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
Met de eerste opdracht wordt de gebruikersrol met de naam CustomRole opgeslagen en vervolgens opgeslagen in de variabele $Role.
Met de tweede opdracht wordt de inhoud van $Role weergegeven.
Met de derde opdracht worden de klassen van $Role weergegeven.
Parameters
-ComputerName
Hiermee geeft u de naam van de computer waarop de System Center Data Access-service wordt uitgevoerd. Het gebruikersaccount dat is opgegeven in de referentieparameter moet toegangsrechten hebben voor de opgegeven computer.
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Hiermee geeft u de referenties op die deze cmdlet gebruikt om verbinding te maken met de server waarop de System Center Data Access-service wordt uitgevoerd. Het opgegeven gebruikersaccount moet toegangsrechten voor die server hebben.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Hiermee geeft u de weergavenaam op van de gebruikersrol die moet worden opgehaald. U kunt een reguliere expressie opgeven.
Type: | System.String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
Hiermee geeft u de id op van de gebruikersrol die moet worden opgehaald.
Type: | System.Guid[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de naam op van de gebruikersrol die moet worden opgehaald. U kunt een reguliere expressie opgeven.
Type: | System.String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Hiermee geeft u een -object op dat een sessie naar een Service Manager-beheerserver vertegenwoordigt.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
System.String
U kunt een naam doorspezen naar de parameter DisplayName .
System.Guid
U kunt een GUID doorsluisen naar de parameter Id .
Uitvoerwaarden
Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
Het object UserRole biedt informatie over de Service Manager gebruikersrollen. Dit object kan worden gebruikt in combinatie met de cmdlet Update-SCSMUserRole om een gebruiker toe te voegen aan een gebruikersrol.