Dela via


Start-CMClientSettingDeployment

SYNOPSIS

(Inaktuell) Distribuerar klientinställningar till enheter i en samling.

SYNTAX

SearchByClientSettingName_CollectionValue (standard)

Start-CMClientSettingDeployment -ClientSettingName <String> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingValue_CollectionId

Start-CMClientSettingDeployment -ClientSetting <IResultObject> -CollectionId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingValue_CollectionName

Start-CMClientSettingDeployment -ClientSetting <IResultObject> -CollectionName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingValue_CollectionValue

Start-CMClientSettingDeployment -ClientSetting <IResultObject> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingId_CollectionId

Start-CMClientSettingDeployment -ClientSettingId <String> -CollectionId <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingId_CollectionName

Start-CMClientSettingDeployment -ClientSettingId <String> -CollectionName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingId_CollectionValue

Start-CMClientSettingDeployment -ClientSettingId <String> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingName_CollectionId

Start-CMClientSettingDeployment -ClientSettingName <String> -CollectionId <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByClientSettingName_CollectionName

Start-CMClientSettingDeployment -ClientSettingName <String> -CollectionName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Start-CMClientSettingDeployment distribuerar klientinställningar till enheter i en Konfigurationshanteraren samling. Ange klientinställningsobjektet med hjälp av dess namn eller ID, eller så kan du använda cmdleten Get-CMClientSetting för att hämta ett klientinställningsobjekt. Ange vilken samling inställningarna ska tillämpas på med hjälp av dess namn eller ID, eller så kan du använda cmdleten Get-CMDeviceCollection för att hämta en enhetssamling.

Mer information om klientinställningar finns i Om Klientinställningar Inställningar i Konfigurationshanteraren.

Viktigt

Från och med version 2107 är denna cmdlet inaktuell och kan tas bort i en framtida version. Använd i stället cmdleten New-CMClientSettingDeployment.

EXAMPLES

Exempel 1: Distribuera ett klientinställningsobjekt med hjälp av dess ID till en namngiven samling

PS XYZ:\> Start-CMClientSettingDeployment -ClientSettingId "CSI1023" -CollectionName "General Computer Collection"

Det här kommandot startar distributionen av klientinställningsobjektet som har ID CSI1023 för samlingen med namnet General Computer Collection.

Exempel 2: Distribuera ett klientinställningsobjekt med hjälp av en variabel

PS XYZ:\> $CSID = Get-CMClientSetting -Id "CSI1023"
PS XYZ:\> Start-CMClientSettingDeployment -ClientSetting $CSID -CollectionName "General Computer Collection"

Det första kommandot hämtar ett klientinställningsobjekt som har ID CSI1023 och sparar det i $CSID variabeln.

Det andra kommandot startar distributionen av klientinställningsobjektet i $CSID till samlingen med namnet General Computer Collection.

PARAMETERS

-ClientSetting

Anger ett klientinställningsobjekt. Om du vill hämta ett klientinställningsobjekt använder du cmdleten Get-CMClientSetting.

Type: IResultObject
Parameter Sets: SearchByClientSettingValue_CollectionId, SearchByClientSettingValue_CollectionName, SearchByClientSettingValue_CollectionValue
Aliases:

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

-ClientSettingId

Anger ID för ett klientinställningsobjekt.

Type: String
Parameter Sets: SearchByClientSettingId_CollectionId, SearchByClientSettingId_CollectionName, SearchByClientSettingId_CollectionValue
Aliases:

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

-ClientSettingName

Anger namnet på ett klientinställningsobjekt.

Type: String
Parameter Sets: SearchByClientSettingName_CollectionValue, SearchByClientSettingName_CollectionId, SearchByClientSettingName_CollectionName
Aliases:

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

-Samling

Anger ett Konfigurationshanteraren samlingsobjekt. Om du vill hämta ett samlingsobjekt använder du cmdleten Get-CMDeviceCollection. Konfigurationshanteraren tillämpar klientinställningarna på medlemmarna i den här samlingen.

Type: IResultObject
Parameter Sets: SearchByClientSettingName_CollectionValue, SearchByClientSettingValue_CollectionValue, SearchByClientSettingId_CollectionValue
Aliases:

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

-CollectionId

Anger ID för en Konfigurationshanteraren samling. Konfigurationshanteraren tillämpar klientinställningarna på medlemmarna i den här samlingen.

Type: String
Parameter Sets: SearchByClientSettingValue_CollectionId, SearchByClientSettingId_CollectionId, SearchByClientSettingName_CollectionId
Aliases:

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

-CollectionName

Anger namnet på en Konfigurationshanteraren samling. Konfigurationshanteraren tillämpar klientinställningarna på medlemmarna i den här samlingen.

Type: String
Parameter Sets: SearchByClientSettingValue_CollectionName, SearchByClientSettingId_CollectionName, SearchByClientSettingName_CollectionName
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMClientSetting

Get-CMDeviceCollection