Get-SCSMConnector
Get-SCSMConnector
Retrieves connectors that are defined in Service Manager.
Syntax
Parameter Set: FromEMODisplayNameParameterSetName
Get-SCSMConnector [-DisplayName] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromEMOIdParameterSetName
Get-SCSMConnector [-Id] <Guid[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromEMONameParameterSetName
Get-SCSMConnector [-Name] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Detailed Description
The Get-SCSMConnector cmdlet retrieves connectors that are defined in Service Manager. If the Name parameter is omitted, then all connectors are retrieved. For each returned connector, the cmdlet displays type, name, and status information.
Parameters
-ComputerName<String[]>
Specifies the name of the computer on which the Service Manager SDK Service is running. 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? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Credential<PSCredential>
Represents a user with the credentials to interact with Service Manager. If not properly specified, a terminating error of PrivilegeDenied appears.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-DisplayName<String[]>
Specifies the DisplayName of the connector to retrieve.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Id<Guid[]>
Specifies the ID of the connector to retrieve.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies the Name of the connector to retrieve; this can be a regular expression.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
.* |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-SCSession<Connection[]>
Specifies an object that represents the session to a Service Manager management server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
System.String
You can pipe a name to the Name parameter of the
Get-SCSMConnectorcmdlet.System.Guid
You can pipe a GUID to the Id parameter of the
Get-SCSMConnectorcmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.ADConnector
This cmdlet retrieves connector objects including the information describing each connector and its properties.
Examples
------------------------- EXAMPLE 1 --------------------------
This command retrieves all connectors and for each connector displays its status, display name, and its data provider.
C:\PS>Get-SCSMConnector
-------------------------- EXAMPLE 2 --------------------------
This command retrieves all connectors whose DisplayName matches the string "SCSM".
C:\PS>Get-SCSMConnector –DisplayName SCSM*