Delen via


Start-CMClientSettingDeployment

SYNOPSIS

(Afgeschaft) Implementeert clientinstellingen op apparaten in een verzameling.

SYNTAX

SearchByClientSettingName_CollectionValue (standaard)

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

Met de cmdlet Start-CMClientSettingDeployment worden clientinstellingen geïmplementeerd op apparaten in Configuration Manager verzameling. Geef het clientinstellingsobject op met behulp van de naam of id, of u kunt de cmdlet Get-CMClientSetting gebruiken om een clientinstellingsobject op te halen. Geef de verzameling op waarin de instellingen moeten worden toegepast met behulp van de naam of id, of u kunt de cmdlet Get-CMDeviceCollection gebruiken om een apparaatverzameling op te halen.

Zie About Client Instellingen in Configuration Manager (Clientinstellingen in Configuration Manager) voor meer informatie over clientinstellingen.

Belangrijk

Vanaf versie 2107 is deze cmdlet afgeschaft en kan deze in een toekomstige release worden verwijderd. Gebruik in plaats daarvan de cmdlet New-CMClientSettingDeployment.

EXAMPLES

Voorbeeld 1: een clientinstellingsobject implementeren met behulp van de id naar een benoemde verzameling

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

Met deze opdracht wordt de implementatie gestart van het clientinstellingsobject met de id CSI1023 voor de verzameling met de naam General Computer Collection.

Voorbeeld 2: een clientinstellingsobject implementeren met behulp van een variabele

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

Met de eerste opdracht wordt een clientinstellingsobject met de ID CSI1023 op de clientinstellingsvariabele $CSID op te geven.

De tweede opdracht start de implementatie van het clientinstellingsobject in de $CSID variabele naar de verzameling met de naam General Computer Collection.

PARAMETERS

-ClientSetting

Hiermee geeft u een clientinstellingsobject op. Als u een clientinstellingsobject wilt verkrijgen, gebruikt u de cmdlet 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

Hiermee geeft u de id van een clientinstellingsobject op.

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

Hiermee geeft u de naam van een clientinstellingsobject.

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

-Collection

Hiermee geeft u een Configuration Manager verzamelingsobject. Als u een verzamelingsobject wilt ophalen, gebruikt u de cmdlet Get-CMDeviceCollection. Configuration Manager clientinstellingen worden toegepast op de leden van deze verzameling.

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

Hiermee geeft u de id van een Configuration Manager verzameling. Configuration Manager clientinstellingen worden toegepast op de leden van deze verzameling.

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

Hiermee geeft u de naam van een Configuration Manager verzameling. Configuration Manager clientinstellingen worden toegepast op de leden van deze verzameling.

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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Get-CMClientSetting

Get-CMDeviceCollection