Condividi tramite

Set-CMConfigurationItem

  • Riferimento
Modulo:
ConfigurationManager

Modifica le impostazioni per un elemento di configurazione di Configuration Manager.

Sintassi

Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Id] <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Name] <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-CMConfigurationItem modifica le impostazioni per un elemento di configurazione di Configuration Manager.

Gli elementi di configurazione contengono una o più impostazioni, insieme alle regole di conformità. Gli elementi in genere definiscono un'unità di configurazione da monitorare. Per altre informazioni sugli elementi di configurazione, vedere Introduzione alle impostazioni di conformità in Configuration Manager.

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: Modificare il nome di un elemento di configurazione

PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"

Questo comando modifica il nome dell'elemento di configurazione denominato CITest in CITest01.

Esempio 2: Impostare le impostazioni degli elementi

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"

Questo comando imposta l'azione dell'ambito di sicurezza su AddMembership e il nome dell'ambito di sicurezza su DefaultScope per l'elemento denominato CITest01.

Esempio 3: Modificare le impostazioni degli elementi

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"

Questo comando imposta l'azione dell'ambito di sicurezza su RemoveMembership e il nome dell'ambito di sicurezza su DefaultScope per l'elemento denominato CITest01.

Parametri

-AddCategory

Specifica una matrice di nomi localizzati delle categorie a cui appartiene l'elemento di configurazione.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
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

-Description

Specifica una descrizione per un elemento di configurazione.

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

-Digest

Specifica il digest che contiene l'elemento di configurazione.

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

-DigestPath

Specifica il percorso del digest.

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

-DigestXml

Specifica la definizione XML.

Tipo:String
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

Specifica una matrice di identificatori per uno o più elementi di configurazione. È possibile usare un elenco delimitato da virgole.

Tipo:Int32
Alias:CIId, CI_ID
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto elemento di configurazione. Per ottenere un oggetto elemento di configurazione, è possibile usare il cmdlet Get-CMConfigurationItem .

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

-Name

Specifica una matrice di nomi per gli elementi di configurazione.

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

-NewName

Specifica un nuovo nome per un elemento di configurazione.

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

-PassThru

Restituisce l'oggetto di lavoro corrente. Per impostazione predefinita, il cmdlet non genera alcun output.

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

-RemoveCategory

Specifica una matrice di nomi localizzati delle categorie da cui rimuovere l'elemento di configurazione.

Tipo:String[]
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