Export (0) Print
Expand All

Get-SCSMRunAsAccount

Get-SCSMRunAsAccount

Retrieves the RunAs accounts available in the Service Manager environment.

Syntax

Parameter Set: Default
Get-SCSMRunAsAccount [-ComputerName <String> ] [-Credential <PSCredential> ] [-RunAsProfileName <String[]> ] [ <CommonParameters>]




Detailed Description

Retrieves the RunAs accounts available in the Service Manager environment. RunAs accounts contain the user credentials under which workflows run. These accounts allow Service Manager to act on behalf of a specific user. If the RunAsProfileName parameter is omitted, all RunAs accounts are returned. If the RunAsProfileName parameter is specified, the specified value is interpreted as a regular expression. All RunAs accounts whose Name or Display Name property matches the regular expression are returned.

Parameters

-ComputerName<String>

Specifies the name of the computer on which the Service Manager SDK Service is running. The default value is "localhost". The user account that is defined in the Credential parameter must have access rights to the specified computer.


Aliases

none

Required?

false

Position?

named

Default Value

localhost

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies the credentials to use when you connect to the server on which the Service Manager SDK Service is running. The provided user account must have access to that server. The default value for this parameter is the user account of the current context.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsProfileName<String[]>

Specifies the RunAs account to retrieve. This parameter is interpreted as a regular expression.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Outputs

The output type is the type of the objects that the cmdlet emits.

  • RunAsAccount object

    The object that encapsulates the RunAs account name and the credentials associated with that RunAs account.


Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This command retrieves RunAs account information from the Service Manager environment.


C:\PS>Get-SCSMRunAsAccountPS> Get-SCSMRunAsAccountRunAsProfileName                                  UserName----------------                                  ----------Domain Admin                                      WOODGROVE\AdministratorAutomatic Agent Management AccountReservedReservedPrivileged Monitoring AccountActive Directory Based Agent Assignment AccountValidate Alert Subscription AccountOperational Database AccountMicrosoft.SystemCenter.PrimaryDeploymentAccount

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

This command retrieves RunAs account information from the Service Manager environment for the "Domain Admin" RunAs account.


C:\PS>Get-SCSMRunAsAccount -RunAsProfileName "Domain Admin"PS> Get-SCSMRunAsAccountRunAsProfileName                                  UserName----------------                                  ----------Domain Admin                                      WOODGROVE\Administrator

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft