Condividi tramite


Set-CMGlobalCondition

Modifica le impostazioni per una condizione globale di Configuration Manager.

Sintassi

Set-CMGlobalCondition
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-AssemblyName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Class <String>]
   -Name <String>
   [-Namespace <String>]
   [-PassThru]
   [-Property <String>]
   [-WhereClause <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-UseDefaultInstance]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-UseAllInstances]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   [-InstanceName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-DistinguishedName <String>]
   [-LdapFilter <String>]
   [-LdapPrefix <String>]
   -Name <String>
   [-PassThru]
   [-Property <String>]
   [-SearchScope <SearchScope>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FileOrFolderName <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-Path <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FilePath <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-ScriptLanguage <ScriptingLanguage>]
   [-Use32BitHost <Boolean>]
   [-UseLoggedOnUserCredential <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FilePath <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-XmlFilePath <String>]
   [-XmlNamespace <String[]>]
   [-XPathQuery <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Is64Bit <Boolean>]
   [-KeyName <String>]
   -Name <String>
   [-PassThru]
   [-RegistryHive <RegistryRootKey>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Is64Bit <Boolean>]
   [-KeyName <String>]
   -Name <String>
   [-PassThru]
   [-RegistryHive <RegistryRootKey>]
   [-ValueName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-MetabasePath <String>]
   -Name <String>
   [-PassThru]
   [-PropertyId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   -Name <String>
   -OmaUri <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-CMGlobalCondition modifica le impostazioni per una condizione globale. È possibile aggiungere o rimuovere un ambito di sicurezza per una condizione globale. È possibile specificare una condizione globale in base al nome o all'ID oppure usare il cmdlet Get-CMGlobalCondition per ottenere un oggetto condizione globale.

Configuration Manager usa le condizioni globali per rappresentare le condizioni aziendali o tecniche. Le condizioni globali specificano come fornire e distribuire applicazioni nei dispositivi client.

Ogni condizione globale deve avere almeno un ambito di sicurezza.

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: Aggiungere un ambito di sicurezza

PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"

Questo comando aggiunge l'ambito di sicurezza denominato Scope22 alla condizione globale denominata velocità DELLA CPU.

Esempio 2: Rimuovere un ambito di sicurezza usando una variabile

PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"

Il primo comando usa il cmdlet Get-CMGlobalCondition per ottenere la condizione globale denominata velocità CPU e archiviarla nella variabile $CMGC.

Il secondo comando rimuove l'ambito di sicurezza denominato Scope22 dalla condizione globale archiviata nella variabile $CMGC.

Parametri

-AssemblyName

Specifica il nome di un assembly per il quale eseguire la ricerca. Un nome di assembly deve essere registrato nella Global Assembly Cache.

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

-Class

Specifica una classe Strumentazione gestione Windows (WMI) usata per compilare una query WQL (WMI Query Language). La query valuta la conformità nei computer client.

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

-Column

Specifica il nome della colonna utilizzato per valutare la conformità della condizione globale.

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

-Database

Specifica il nome di un database. La query SQL viene eseguita in questo database.

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

-Description

Specifica una descrizione per la condizione globale.

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

-DistinguishedName

Specifica il nome distinto dell'oggetto Active Directory Domain Services (AD DS) da valutare per la conformità nei computer client.

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

-FileOrFolderName

Specifica il nome di un file o di una cartella. Specificare il parametro IsFolder per cercare una cartella.

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

-FilePath

Specifica un percorso di file per il file valutato dalla condizione per la conformità.

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

-IncludeSubfolder

Indica se il cmdlet include sottocartelle nell'operazione.

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

-InstanceName

Specifica il nome di un'istanza di database eseguita dalla condizione globale. Per eseguire una ricerca nell'istanza predefinita, specificare il parametro UseDefaultInstance . Per eseguire ricerche in tutte le istanze, specificare il parametro UseAllInstances .

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

-Is64Bit

Indica che la condizione globale cerca il percorso del file di sistema a 64 bit oltre al percorso del file di sistema a 32 bit.

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

-KeyName

Specifica il nome della chiave del Registro di sistema per cui eseguire la ricerca. Usare la chiave di formato\sottochiave.

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

-LdapFilter

Specifica un filtro LDAP (Lightweight Directory Access Protocol) per perfezionare i risultati della query di Active Directory Domain Services per valutare la conformità nei computer client.

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

-LdapPrefix

Specifica un prefisso LDAP valido per la query di Active Directory Domain Services che valuta la conformità nei computer client. I valori accettabili per questo parametro sono: LDAP:// o GC://.

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

-MetabasePath

Specifica il percorso del file della metabase per Internet Information Services (IIS).

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

-Name

Specifica il nome delle condizioni globali. Questo valore corrisponde alla proprietà LocalizedDisplayName di un oggetto condizione globale.

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

-Namespace

Specifica uno spazio dei nomi da un repository WMI. Il valore predefinito è Root\cimv2.

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

-NewName

Specifica un nuovo nome per la condizione globale.

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

-OmaUri

Specifica un URI (Uniform Resource Indicator) che punta ai parametri specifici del dispositivo per un dispositivo Open Mobile Alliance (OMA).

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

-Path

Specifica il percorso per un URI OMA.

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

-Property

Specifica la proprietà dell'oggetto Active Directory Domain Services usato per valutare la conformità nei computer client.

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

-PropertyId

Specifica la proprietà di Servizi di dominio Active Directory usata da Configuration Manager per determinare la conformità del client.

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

-RegistryHive

Specifica la chiave radice nel Registro di sistema che identifica l'hive del Registro di sistema in cui si esegue la ricerca. WMI usa l'hive del Registro di sistema per restituire, impostare e modificare i valori delle chiavi del Registro di sistema. I valori consentiti per questo parametro sono:

  • ClassesRoot
  • CurrentConfig
  • CurrentUser
  • LocalMachine
  • Utenti
Tipo:RegistryRootKey
Valori accettati:ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScriptLanguage

Specifica un linguaggio di scripting da utilizzare. I valori consentiti per questo parametro sono:

  • PowerShell
  • VBScript
  • JScript
Tipo:ScriptingLanguage
Valori accettati:PowerShell, VBScript, JScript, ShellScript
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SearchScope

Specifica l'ambito di ricerca in Active Directory Domain Services. I valori consentiti per questo parametro sono:

  • Base
  • OneLevel
  • Sottoalbero
Tipo:SearchScope
Valori accettati:Base, OneLevel, Subtree
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Use32BitHost

Indica che il file o la cartella è associato a un'applicazione a 64 bit.

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

-UseAllInstances

Indica che la condizione globale esegue la ricerca in tutte le istanze del database. Per eseguire una ricerca in un'istanza denominata, specificare il parametro InstanceName . Per eseguire una ricerca nell'istanza predefinita, specificare il parametro UseDefaultInstance .

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

-UseDefaultInstance

Indica che la condizione globale esegue la ricerca nell'istanza di database predefinita. Per eseguire una ricerca in un'istanza denominata, specificare il parametro InstanceName . Per eseguire ricerche in tutte le istanze, specificare il parametro UseAllInstances .

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

-UseLoggedOnUserCredential

Indica se usare le credenziali utente registrate.

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

-ValueName

Specifica il valore da contenere nella chiave del Registro di sistema specificata.

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

-WhereClause

Specifica una clausola WHERE della query WQL da applicare allo spazio dei nomi, alla classe e alla proprietà specificati nei computer client.

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

-XmlFilePath

Specifica un file che contiene la query XML da utilizzare per valutare la conformità nei computer client.

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

-XmlNamespace

Specifica una matrice di query XPath (Full XML Path Language) valide da usare per valutare la conformità nei computer client.

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

-XPathQuery

Specifica una query XPath.

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

Input

None

Output

System.Object