Condividi tramite

New-CMClientSettingDeployment

  • Riferimento
Modulo:
ConfigurationManager

Distribuire un'impostazione client personalizzata.

Sintassi

New-CMClientSettingDeployment
   -Name <String>
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMClientSettingDeployment
   -Id <String>
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMClientSettingDeployment
   -InputObject <IResultObject>
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per distribuire un'impostazione client personalizzata. Quando si distribuiscono impostazioni personalizzate, queste sostituiscono le impostazioni client predefinite. Le impostazioni client personalizzate con priorità più alta possono anche sostituire altre impostazioni. Per altre informazioni, vedere Creare e distribuire impostazioni client personalizzate.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

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

New-CMClientSettingDeployment -Id "16777225" -CollectionName "General Computer Collection"

Parametri

-Collection

Specificare un oggetto raccolta come destinazione per la distribuzione. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .

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

-CollectionId

Specificare un ID per la raccolta per la distribuzione. Questo valore è un ID raccolta standard, ad esempio XYZ00042.

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

-CollectionName

Specificare un nome di raccolta per la distribuzione.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
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

-Id

Specificare l'ID delle impostazioni client personalizzate da distribuire. Questo ID è l'ID impostazioni nella console e la proprietà SettingsID nella classe WMI SMS_ClientSettings .

È possibile usare il cmdlet Get-CMClientSetting per ottenere questa proprietà. Ad esempio, (Get-CMClientSetting -Name "Remote control").SettingsID

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

-InputObject

Specificare un oggetto impostazioni client personalizzato da distribuire. Per ottenere questo oggetto, usare il cmdlet Get-CMClientSetting .

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

-Name

Specificare il nome delle impostazioni client personalizzate da distribuire.

Tipo:String
Alias:ClientSettingName
Posizione:Named
Valore predefinito:None
Necessario:True
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:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object