Edit

Share via

Set-CMSoftwareDistributionComponent

Module:
ConfigurationManager Module

Sets properties of a software distribution component in Configuration Manager.

Syntax

SearchBySiteCodeMandatory (Default) 

Set-CMSoftwareDistributionComponent
    [-AddNetworkAccessAccountName <String[]>]
    [-CleanNetworkAccessAccountName]
    [-DelayBeforeRetryingMins <Int32>]
    [-MaximumPackageCount <Int32>]
    [-MaximumThreadCountPerPackage <Int32>]
    [-MulticastDelayBeforeRetryingMins <Int32>]
    [-MulticastRetryCount <Int32>]
    [-NetworkAccessAccountName <String[]>]
    [-RemoveNetworkAccessAccountName <String[]>]
    [-RetryCount <Int32>]
    [-SiteCode <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchBySiteCodeMandatory_ClientComputerAccount 

Set-CMSoftwareDistributionComponent
    [-ClientComputerAccount]
    [-DelayBeforeRetryingMins <Int32>]
    [-MaximumPackageCount <Int32>]
    [-MaximumThreadCountPerPackage <Int32>]
    [-MulticastDelayBeforeRetryingMins <Int32>]
    [-MulticastRetryCount <Int32>]
    [-RetryCount <Int32>]
    [-SiteCode <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-CMSoftwareDistributionComponent cmdlet sets properties of a software distribution component in Configuration Manager. You can configure the properties of an object to meet the demands that clients place on the Configuration Manager site.

Note

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

Examples

Example 1: Set properties of a software distribution component

PS XYZ:\> Set-CMSoftwareDistributionComponent -SiteCode "CM2" -MaximumPackageCount 3 -MaximumThreadsPerPackage 6 -RetryCount 99 -DelayBeforeRetryingMinutes 31 -MulticastRetryCount 4 -MulticastDelayBeforeRetryingMinutes 2 -NetworkAccessAccount "Western\ElisaDaugherty"

The following command sets all properties for a software distribution component.

Parameters

-AddNetworkAccessAccountName

{{ Fill AddNetworkAccessAccountName Description }}

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:AddNetworkAccessAccountNames

Parameter sets

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

-CleanNetworkAccessAccountName

{{ Fill CleanNetworkAccessAccountName Description }}

Parameter properties

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

Parameter sets

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

-ClientComputerAccount

Indicates that the cmdlet uses a client computer account.

Parameter properties

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

Parameter sets

SearchBySiteCodeMandatory_ClientComputerAccount
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

-DelayBeforeRetryingMins

The Set-CMSoftwareDistributionComponent cmdlet sets properties of a software distribution component in Configuration Manager. You can configure the properties of an object to meet the demands that clients place on the Configuration Manager site.

Note

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:DelayBeforeRetryingMinutes

Parameter sets

(All)
Position:Named
Mandatory:False
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

-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

-MaximumPackageCount

Specifies a maximum number of packages.

Parameter properties

Type:Int32
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

-MaximumThreadCountPerPackage

The Set-CMSoftwareDistributionComponent cmdlet sets properties of a software distribution component in Configuration Manager. You can configure the properties of an object to meet the demands that clients place on the Configuration Manager site.

Note

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:MaximumThreadsPerPackage

Parameter sets

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

-MulticastDelayBeforeRetryingMins

The Set-CMSoftwareDistributionComponent cmdlet sets properties of a software distribution component in Configuration Manager. You can configure the properties of an object to meet the demands that clients place on the Configuration Manager site.

Note

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:MulticastDelayBeforeRetryingMinutes

Parameter sets

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

-MulticastRetryCount

Specifies a retry count for multicast software distribution attempts.

Parameter properties

Type:Int32
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

-NetworkAccessAccountName

Specifies an account name for network access.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:NetworkAccessAccountNames

Parameter sets

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

-RemoveNetworkAccessAccountName

{{ Fill RemoveNetworkAccessAccountName Description }}

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:RemoveNetworkAccessAccountNames

Parameter sets

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

-RetryCount

Specifies a retry count.

Parameter properties

Type:Int32
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

-SiteCode

Specifies a site code of a Configuration Manager site.

Parameter properties

Type:String
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

-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

None