Set-CMApplicationCatalogWebsitePoint

SYNOPSIS

Changes the settings of an Application Catalog website point.

SYNTAX

SetByValue (Default)

Set-CMApplicationCatalogWebsitePoint [-ApplicationWebServicePointServerName <String>] [-NetBiosName <String>]
 [-OrganizationName <String>] [-CommunicationType <ComputerCommunicationType>]
 [-ClientConnectionType <ClientConnectionTypes>] [-ColorRed <Int32>] [-ColorGreen <Int32>] [-ColorBlue <Int32>]
 [-Color <Color>] -InputObject <IResultObject> [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMApplicationCatalogWebsitePoint [-SiteCode <String>] [-SiteSystemServerName] <String>
 [-ApplicationWebServicePointServerName <String>] [-NetBiosName <String>] [-OrganizationName <String>]
 [-CommunicationType <ComputerCommunicationType>] [-ClientConnectionType <ClientConnectionTypes>]
 [-ColorRed <Int32>] [-ColorGreen <Int32>] [-ColorBlue <Int32>] [-Color <Color>] [-PassThru]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-CMApplicationCatalogWebsitePoint cmdlet changes the settings of an Application Catalog website point in Microsoft System Center Configuration Manager. This site system role supports the Application Catalog website.

Specify the site that this website point supports and the server that hosts the website point. You can specify the website name and NetBIOS name of the Application Catalog.

You can customize the page that users see when they connect to the Application Catalog. Specify custom values for the colors blue, green, and red. You can also specify a name for users to see in the browser, such as a company name or a division within a company.

EXAMPLES

Example 1: Change the settings of an Application Catalog website point

PS C:\> Set-CMApplicationCatalogWebsitePoint -SiteSystemServerName "CMDIV-WEST04.CORP.CONTOSO.COM" -SiteCode "CM4" -NetbiosName "CMDIV-WEST02" -OrganizationName "MarketingWest" -ColorRed 168 -ColorGreen 201 -ColorBlue 52

This command changes the settings of the Application Catalog website point hosted on the site system server named CMDIV-WEST04.CORP.CONTOSO.COM. The command specifies that the NetBIOS server named CMDIV-WEST02 hosts the Application Catalog website point. The command specifies that Configuration Manager displays the organization name MarketingWest in the Software Center, and sets the custom colors for the Software Center.

Example 2: Change the settings of an Application Catalog website point by object variable

PS C:\> $Acwp= Get-CMApplicationCatalogWebsitePoint -SiteSystemServerName "CMDIV-WEST04.CORP.CONTOSO.COM" -SiteCode "CM4" 
PS C:\> Set-CMApplicationCatalogWebsitePoint -InputObject $Acwp -NetbiosName "CMDIV-WEST02" -OrganizationName "MarketingWest" -ColorR 160 -ColorG 200 -ColorB 50

The first command uses the Get-CMApplicationCatalogWebsitePoint cmdlet to get the Application Catalog website point that is associated with the site system server named CMDIV-WEST04.CORP.CONTOSO.COM that is hosted on the Configuration Manager site that has the site code CM4. The command stores the result in the $Acwp variable.

The second command changes the settings of the Application Catalog website point stored in $Acwp. The command specifies that the NetBIOS server named CMDIV-WEST02 hosts the Application Catalog website point. The command specifies that Configuration Manager displays the organization name MarketingWest in the Software Center, and sets the custom colors for the Software Center.

PARAMETERS

-ApplicationWebServicePointServerName

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

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

-ClientConnectionType

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

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

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

-Color

Type: Color
Parameter Sets: (All)
Aliases: 

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

-ColorBlue

Specifies an integer value for a custom blue color. Configuration Manager uses custom colors to conform to customer branding.

Type: Int32
Parameter Sets: (All)
Aliases: 

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

-ColorGreen

Specifies an integer value for a custom green color. Configuration Manager uses custom colors to conform to customer branding.

Type: Int32
Parameter Sets: (All)
Aliases: 

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

-ColorRed

Specifies an integer value for a custom red color. Configuration Manager uses custom colors to conform to customer branding.

Type: Int32
Parameter Sets: (All)
Aliases: 

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

-CommunicationType

Type: ComputerCommunicationType
Parameter Sets: (All)
Aliases: ClientCommunicationType
Accepted values: Http, Https

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

-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

-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

-InputObject

Specifies an Application Catalog website point object. To obtain Application Catalog website point object, use the Get-CMApplicationCatalogWebsitePoint cmdlet.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: ApplicationCatalogWebsitePoint

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

-NetBiosName

Specifies the NetBIOS name of the server that hosts the Application Catalog website point.

Type: String
Parameter Sets: (All)
Aliases: 

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

-OrganizationName

Specifies a name for a customer organization. This name appears to users who access the Application Catalog.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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 for a Configuration Manager site.

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 a server that hosts a 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

-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-CMApplicationCatalogWebsitePoint

Get-CMApplicationCatalogWebServicePoint

Get-CMApplicationCatalogWebsitePoint

Remove-CMApplicationCatalogWebSitePoint