Add-CMManagementPoint

Adds a management point to Configuration Manager.

Syntax

Add-CMManagementPoint
   [-AllowDevice]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-CommunicationType <ComputerCommunicationType>]
   [-ConnectionAccountUserName <String>]
   [-EnableCloudGateway]
   [-EnableSsl]
   [-GenerateAlert]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMManagementPoint
   [-AllowDevice]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-CommunicationType <ComputerCommunicationType>]
   [-ConnectionAccountUserName <String>]
   [-EnableCloudGateway]
   [-EnableSsl]
   [-GenerateAlert]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMManagementPoint
   [-AllowDevice]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-CommunicationType <ComputerCommunicationType>]
   [-ConnectionAccountUserName <String>]
   -DatabaseName <String>
   [-EnableCloudGateway]
   [-EnableSsl]
   [-GenerateAlert]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   -SqlServerFqdn <String>
   [-SqlServerInstanceName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMManagementPoint
   [-AllowDevice]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-CommunicationType <ComputerCommunicationType>]
   [-ConnectionAccountUserName <String>]
   -DatabaseName <String>
   [-EnableCloudGateway]
   [-EnableSsl]
   [-GenerateAlert]
   [-InputObject] <IResultObject>
   -SqlServerFqdn <String>
   [-SqlServerInstanceName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-CMManagementPoint cmdlet adds a management point to Configuration Manager. A management point is a Configuration Manager site system role that provides policy and service information to clients and receives configuration data from clients.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Add a management point

PS XYZ:\>Add-CMManagementPoint -SiteSystemServerName "CMDEV-TEST02.TSQA.CONTOSO.COM" -SiteCode "CM2" -ClientConnectionType InternetAndIntranet -AllowDevice $True -GenerateAlert -SQLServerFqdnName "CMDEV-TEST02.TSQA.CONTOSO.COM" -SQLServerInstanceName "MSSQLServer" -DatabaseName "test" -UserName "TSQA\MPAdmin" -Verbose

This command adds a management point to a Configuration Manager installation. The command specifies the following information about the management point:

  • The new management point appears on the site system named CMDEV-TEST02.TSQA.CONTOSO.COM. This name is also the fully qualified domain name for the SQL Server instance named MSSQLServer.
  • The site has code CM2.
  • The management point accepts connections from internet and intranet clients and from portable devices.
  • The management point has the associated database name Test.
  • The management point uses the domain user account for the user named TSQA\MPAdmin.
  • The cmdlet displays all messages that the addition operation generates.

Parameters

-AllowDevice

Indicates that the management point supports device clients.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientConnectionType

Specifies the type of the client connection. Valid values are:

  • Internet
  • InternetAndIntranet
  • Intranet
Type:ClientConnectionTypes
Accepted values:Internet, Intranet, InternetAndIntranet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommunicationType

Type:ComputerCommunicationType
Aliases:ClientCommunicationType
Accepted values:Http, Https
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionAccountUserName

Type:String
Aliases:UserName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Specifies the name of the site database or site database replica that the management point uses to query for site database information.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableCloudGateway

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableSsl

Indicates that the cmdlet enables SSL for the management point.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GenerateAlert

Indicates that Configuration Manager generates an alert when the management point is not healthy.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Type:IResultObject
Aliases:SiteServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SiteCode

Specifies the site code of the Configuration Manager site that hosts the site system role.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteSystemServerName

Specifies the name of the server that hosts the site system role.

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SqlServerFqdn

Type:String
Aliases:SqlServerFqdnName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SqlServerInstanceName

Specifies the name of the SQL Server instance that clients use to communicate with the site system.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject