Start-CMClientSettingDeployment

SYNOPSIS

(Przestarzałe) Wdraża ustawienia klienta na urządzeniach w kolekcji.

SYNTAX

SearchByClientSettingName_CollectionValue (ustawienie domyślne)

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

Polecenie cmdlet Start-CMClientSettingDeployment wdraża ustawienia klienta na urządzeniach w Menedżer konfiguracji kolekcji. Określ obiekt ustawień klienta przy użyciu jego nazwy lub identyfikatora albo użyj polecenia cmdlet Get-CMClientSetting, aby uzyskać obiekt ustawień klienta. Określ kolekcję, do których chcesz zastosować ustawienia, używając jej nazwy lub identyfikatora, lub użyj polecenia cmdlet Get-CMDeviceCollection, aby pobrać kolekcję urządzeń.

Aby uzyskać więcej informacji na temat ustawień klienta, zobacz About Client Ustawienia in Menedżer konfiguracji.

Ważne

Począwszy od wersji 2107, to polecenie cmdlet jest przestarzałe i może zostać usunięte w przyszłej wersji. Zamiast tego użyj polecenia cmdlet New-CMClientSettingDeployment.

EXAMPLES

Przykład 1: Wdrażanie obiektu ustawienia klienta przy użyciu jego identyfikatora w nazwanej kolekcji

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

To polecenie rozpoczyna wdrażanie obiektu ustawienia klienta o identyfikatorze CSI1023 dla kolekcji o nazwie Ogólna kolekcja komputerów.

Przykład 2: Wdrażanie obiektu ustawienia klienta przy użyciu zmiennej

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

Pierwsze polecenie pobiera obiekt ustawień klienta o identyfikatorze CSI1023 i zapisuje go w $CSID zmiennej.

Drugie polecenie rozpoczyna wdrażanie obiektu ustawienia klienta w zmiennej $CSID kolekcji o nazwie Ogólna kolekcja komputerów.

PARAMETERS

-ClientSetting

Określa obiekt ustawień klienta. Aby uzyskać obiekt ustawień klienta, użyj polecenia 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

Określa identyfikator obiektu ustawienia klienta.

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

Określa nazwę obiektu ustawienia klienta.

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 (Kolekcja)

Określa obiekt Menedżer konfiguracji kolekcji. Aby uzyskać obiekt kolekcji, użyj polecenia cmdlet Get-CMDeviceCollection. Menedżer konfiguracji stosuje ustawienia klienta do elementów członkowskich tej kolekcji.

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

Określa identyfikator kolekcji Menedżer konfiguracji kolekcji. Menedżer konfiguracji stosuje ustawienia klienta do elementów członkowskich tej kolekcji.

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

Określa nazwę kolekcji Menedżer konfiguracji kolekcji. Menedżer konfiguracji stosuje ustawienia klienta do elementów członkowskich tej kolekcji.

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

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

UWAGI

Get-CMClientSetting

Get-CMDeviceCollection