Condividi tramite


Start-CMClientSettingDeployment

(Deprecato) Distribuisce le impostazioni client ai dispositivi in una raccolta.

Sintassi

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

Descrizione

Il cmdlet Start-CMClientSettingDeployment distribuisce le impostazioni client ai dispositivi in una raccolta di Configuration Manager. Specificare l'oggetto impostazione client usando il nome o l'ID oppure è possibile usare il cmdlet Get-CMClientSetting per ottenere un oggetto impostazione client. Specificare la raccolta a cui applicare le impostazioni usando il nome o l'ID oppure è possibile usare il cmdlet Get-CMDeviceCollection per ottenere una raccolta di dispositivi.

Per altre informazioni sulle impostazioni client, vedere Informazioni sulle impostazioni client in Configuration Manager.

Importante

A partire dalla versione 2107, questo cmdlet è deprecato e potrebbe essere rimosso in una versione futura. Usare invece il cmdlet New-CMClientSettingDeployment .

Esempio

Esempio 1: Distribuire un oggetto impostazione client usando il relativo ID in una raccolta denominata

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

Questo comando avvia la distribuzione dell'oggetto impostazione client con l'ID CSI1023 per la raccolta denominata General Computer Collection.

Esempio 2: Distribuire un oggetto impostazione client usando una variabile

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

Il primo comando ottiene un oggetto di impostazione client con l'ID CSI1023 e lo salva nella variabile $CSID.

Il secondo comando avvia la distribuzione dell'oggetto impostazione client nella variabile $CSID nell'insieme denominato General Computer Collection.

Parametri

-ClientSetting

Specifica un oggetto impostazione client. Per ottenere un oggetto impostazione client, usare il cmdlet Get-CMClientSetting .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ClientSettingId

Specifica l'ID di un oggetto impostazione client.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientSettingName

Specifica il nome di un oggetto impostazione client.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Collection

Specifica un oggetto raccolta di Configuration Manager. Per ottenere un oggetto raccolta, usare il cmdlet Get-CMDeviceCollection . Configuration Manager applica le impostazioni client ai membri di questa raccolta.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CollectionId

Specifica l'ID di una raccolta di Configuration Manager. Configuration Manager applica le impostazioni client ai membri di questa raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specifica il nome di una raccolta di Configuration Manager. Configuration Manager applica le impostazioni client ai membri di questa raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object