Edit

Share via

Add-CMManagementPoint

Module:
ConfigurationManager Module

Adds a management point to Configuration Manager.

Syntax

ByValueNoReplica (Default) 

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

ByNameNoReplica 

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

ByNameReplica 

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

ByValueReplica 

Add-CMManagementPoint
    [-InputObject] <IResultObject>
    -DatabaseName <String>
    -SqlServerFqdn <String>
    [-AllowDevice]
    [-ClientConnectionType <ClientConnectionTypes>]
    [-CommunicationType <ComputerCommunicationType>]
    [-ConnectionAccountUserName <String>]
    [-EnableCloudGateway]
    [-EnableSsl]
    [-GenerateAlert]
    [-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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClientConnectionType

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

  • Internet
  • InternetAndIntranet
  • Intranet

Parameter properties

Type:ClientConnectionTypes
Default value:None
Accepted values:Internet, Intranet, InternetAndIntranet
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CommunicationType

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.

Parameter properties

Type:ComputerCommunicationType
Default value:None
Accepted values:Http, Https
Supports wildcards:False
DontShow:False
Aliases:ClientCommunicationType

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ConnectionAccountUserName

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:UserName

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DatabaseName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByNameReplica
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ByValueReplica
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableCloudGateway

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableSsl

Indicates that the cmdlet enables SSL for the management point.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GenerateAlert

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

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

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SiteServer

Parameter sets

ByValueNoReplica
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
ByValueReplica
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteCode

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByNameNoReplica
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ByNameReplica
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteSystemServerName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Name, ServerName

Parameter sets

ByNameNoReplica
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ByNameReplica
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SqlServerFqdn

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SqlServerFqdnName

Parameter sets

ByNameReplica
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ByValueReplica
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SqlServerInstanceName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByNameReplica
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ByValueReplica
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject