New-SCSMManagementGroupConnection
New-SCSMManagementGroupConnection
Creates a new connection for the specified management group.
Syntax
Parameter Set: FromComputerNames
New-SCSMManagementGroupConnection [[-ComputerName] <String[]> ] [[-Credential] <PSCredential> ] [-PassThru] [ <CommonParameters>]
Detailed Description
The New-SCSMManagementGroupConnection cmdlet creates a new connection for the specified management group. The last connection that is created with the New-SCManagementGroupConnection cmdlet becomes the active connection that is used by the Get- cmdlets when no –ComputerName or –SCSession parameter is specified. You can use the Set-SCManagementGroupConnection cmdlet to set a different active connection. If a connection already exists, this cmdlet does not create a new connection.
Parameters
-ComputerName<String[]>
Specifies a computer to establish a connection with. The computer must be running the System Center Data Access service. The default value is the computer for the current management group connection.
Valid formats include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN). To specify the local computer, type the computer name, "localhost", or a dot (.).
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
localhost |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Credential<PSCredential>
Specifies a user account under which the management group connection will run. The account must have access to the server that is specified in the ComputerName parameter, if the server is specified. The default value is the current user.
You can enter a PSCredential object that is returned by the Get-Credential cmdlet.
Aliases |
none |
Required? |
false |
Position? |
2 |
Default Value |
Current user context |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-PassThru
Specifies the output object that represents the new session. This output object can be passed to other cmdlets.
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 (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 computer name to the ComputerName parameter of the New-SCSMManagementGroupConnection cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Connection object.
This cmdlet can generate a connection object when it is used with the –PassThru parameter.
Examples
-------------------------- EXAMPLE 1 --------------------------
The commands in this example create a new management group connection.
PS C:\>New-SCSMManagementGroupConnection -ComputerName localhost -Credential (Get-Credential WOODGROVE\Administrator)
PS C:\>Get-SCManagementGroupConnection
Related topics
Get-SCSMManagementGroupConnection