Set-CMGlobalCondition

Modifica le impostazioni per una condizione globale 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 condizioni globali per rappresentare 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 Configuration Manager cmdlet dall'unità del sito 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à 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Column

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

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Database

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

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

-Description

Specifica una descrizione per la condizione globale.

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

-DisableWildcardHandling

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

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

-DistinguishedName

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

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

-FileOrFolderName

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

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

-FilePath

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

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

-ForceWildcardHandling

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

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

-IncludeSubfolder

Indica se il cmdlet include sottocartelle nell'operazione.

Type:Boolean
Aliases:IncludeSubfolders
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-KeyName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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://.

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

-MetabasePath

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

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

-Name

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

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

-Namespace

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

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

-NewName

Specifica un nuovo nome per la condizione globale.

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

-OmaUri

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

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

-PassThru

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

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

-Path

Specifica il percorso per un URI OMA.

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

-Property

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

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

-PropertyId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:RegistryRootKey
Accepted values:ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptLanguage

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

  • PowerShell
  • Vbscript
  • Jscript
Type:ScriptingLanguage
Accepted values:PowerShell, VBScript, JScript, ShellScript
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchScope

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

  • Base
  • OneLevel
  • Sottostruttura
Type:SearchScope
Accepted values:Base, OneLevel, Subtree
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Use32BitHost

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-UseLoggedOnUserCredential

Indica se usare le credenziali utente registrate.

Type:Boolean
Aliases:UseLoggedOnUserCredentials
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValueName

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhereClause

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

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

-XmlFilePath

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

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

-XmlNamespace

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

Type:String[]
Aliases:XmlNamespaces
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-XPathQuery

Specifica una query XPath.

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

Input

None

Output

System.Object