Set-CMManagementPoint

SYNOPSIS

Changes settings for a management point in Configuration Manager.

SYNTAX

SetByValue (Default)

Set-CMManagementPoint -InputObject <IResultObject> [-EnableSsl <Boolean>] [-EnableCloudGateway <Boolean>]
 [-ClientConnectionType <ClientConnectionTypes>] [-AllowDevice <Boolean>] [-GenerateAlert <Boolean>]
 [-UseSiteDatabase <Boolean>] [-SqlServerFqdn <String>] [-SqlServerInstanceName <String>]
 [-DatabaseName <String>] [-UserName <String>] [-UseComputerAccount] [-PassThru] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMManagementPoint [-SiteSystemServerName] <String> [-SiteCode <String>] [-EnableSsl <Boolean>]
 [-EnableCloudGateway <Boolean>] [-ClientConnectionType <ClientConnectionTypes>] [-AllowDevice <Boolean>]
 [-GenerateAlert <Boolean>] [-UseSiteDatabase <Boolean>] [-SqlServerFqdn <String>]
 [-SqlServerInstanceName <String>] [-DatabaseName <String>] [-UserName <String>] [-UseComputerAccount]
 [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-CMManagementPoint cmdlet changes settings for a management point in Microsoft System Center Configuration Manager. A management point is a System Center Configuration Manager site that provides policy and service information to clients and receives configuration data from clients.

EXAMPLES

Example 1: Change management point settings for site system and site code

PS C:\> Set-CMManagementPoint -SiteSystemServerName "CMDEV-TEST02.TSQA.CORP.CONTOSO.COM" -SiteCode "CM2" -EnableSSL $False -UseSiteDatabase $True

This command changes settings for a management point in 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.
  • The site has code CM2.
  • The management point queries a site database for information.
  • The command enables SSL for the management point.

Example 2: Change management point settings for site system and site code, connection type, and database name

PS C:\> Set-CMManagementPoint -SiteSystemServerName "CMDEV-TEST02.TSQA.CORP.CONTOSO.COM " -SiteCode "CM2" -ClientConnectionType InternetAndIntranet -AllowDevice $True -EnableSSL $True -GenerateAlert $False -UseSiteDatabase $False -SQLServerFqdnName "CMDEV-TEST02.TSQA.CORP.CONTOSO.COM" -SQLServerInstanceName "MSSQLServer" -DatabaseName "ContosoSQL01"

This command changes settings for a management point in 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 ContosoSQL01.
  • The command enables SSL for the management point.

PARAMETERS

-AllowDevice

Indicates whether the management point supports device clients.

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-ClientConnectionType

Specifies the type of the client connection. The acceptable values for this parameter are:

  • Internet
  • InternetAndIntranet
  • Intranet
Type: ClientConnectionTypes
Parameter Sets: (All)
Aliases: 
Accepted values: Internet, Intranet, InternetAndIntranet

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: 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
Parameter Sets: (All)
Aliases: 

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

-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-EnableCloudGateway

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-EnableSsl

Indicates whether to enable SSL.

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-GenerateAlert

Indicates whether the management point generates health alerts.

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-InputObject

Specifies the management point for which you change values by using a management point object. To obtain a management point object, use the Get-CMManagementPoint cmdlet.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: ManagementPoint

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-PassThru

Returns the current working object. By default, this cmdlet does not generate any output.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-SiteCode

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

Type: String
Parameter Sets: SetByName
Aliases: 

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

-SiteSystemServerName

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

Type: String
Parameter Sets: SetByName
Aliases: Name, ServerName

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SqlServerFqdn

Type: String
Parameter Sets: (All)
Aliases: SqlServerFqdnName

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: 

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

-UseComputerAccount

Indicates that the management point uses its own computer account instead of a domain user account to access site database information.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-UseSiteDatabase

Indicates whether the management point queries a site database instead of a site database replica for information.

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-UserName

Specifies a domain user account that the management point uses to access site information.

Type: String
Parameter Sets: (All)
Aliases: 

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

Add-CMManagementPoint

Get-CMManagementPoint

Remove-CMManagementPoint