Sdílet prostřednictvím


Set-CMGlobalCondition

SYNOPSIS

Upraví nastavení pro Správce konfigurace podmínku.

SYNTAX

SetGeneral (výchozí)

Set-CMGlobalCondition [-Description <String>] -Name <String> [-NewName <String>] [-PassThru]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetAssembly

Set-CMGlobalCondition [-AssemblyName <String>] -Name <String> [-PassThru] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetWqlQuery

Set-CMGlobalCondition [-Class <String>] -Name <String> [-Namespace <String>] [-PassThru] [-Property <String>]
 [-WhereClause <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetSqlQueryDefaultInstance

Set-CMGlobalCondition [-Column <String>] [-Database <String>] [-FilePath <String>] -Name <String> [-PassThru]
 [-UseDefaultInstance] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetSqlQueryAllInstances

Set-CMGlobalCondition [-Column <String>] [-Database <String>] [-FilePath <String>] -Name <String> [-PassThru]
 [-UseAllInstances] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetSqlQuerySpecificInstance

Set-CMGlobalCondition [-Column <String>] [-Database <String>] [-FilePath <String>] [-InstanceName <String>]
 -Name <String> [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetADQuery

Set-CMGlobalCondition [-DistinguishedName <String>] [-LdapFilter <String>] [-LdapPrefix <String>]
 -Name <String> [-PassThru] [-Property <String>] [-SearchScope <SearchScope>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetFileSystem

Set-CMGlobalCondition [-FileOrFolderName <String>] [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
 -Name <String> [-PassThru] [-Path <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SetFileSystemFile

Set-CMGlobalCondition [-FilePath <String>] [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String>
 [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetScript

Set-CMGlobalCondition [-FilePath <String>] -Name <String> [-PassThru] [-ScriptLanguage <ScriptingLanguage>]
 [-Use32BitHost <Boolean>] [-UseLoggedOnUserCredential <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetXPathQuery

Set-CMGlobalCondition [-FilePath <String>] [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String>
 [-PassThru] [-XmlFilePath <String>] [-XmlNamespace <String[]>] [-XPathQuery <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetRegistryKey

Set-CMGlobalCondition [-Is64Bit <Boolean>] [-KeyName <String>] -Name <String> [-PassThru]
 [-RegistryHive <RegistryRootKey>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetRegistryValue

Set-CMGlobalCondition [-Is64Bit <Boolean>] [-KeyName <String>] -Name <String> [-PassThru]
 [-RegistryHive <RegistryRootKey>] [-ValueName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetIisMetabase

Set-CMGlobalCondition [-MetabasePath <String>] -Name <String> [-PassThru] [-PropertyId <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetOmaUri

Set-CMGlobalCondition -Name <String> -OmaUri <String> [-PassThru] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Rutina Set-CMGlobalCondition upravuje nastavení pro globální podmínku. Můžete přidat nebo odebrat obor zabezpečení pro globální podmínku. Globální podmínku můžete zadat podle názvu nebo ID nebo můžete použít rutinu Get-CMGlobalCondition k získání objektu globální podmínky.

Správce konfigurace používá k reprezentaci obchodních nebo technických podmínek globální podmínky. Globální podmínky určují, jak poskytovat a nasazovat aplikace do klientských zařízení.

Každá globální podmínka musí mít alespoň jeden obor zabezpečení.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Přidání oboru zabezpečení

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

Tento příkaz přidá obor zabezpečení s názvem Scope22 do globální podmínky s názvem Cpu speed.

Příklad 2: Odebrání oboru zabezpečení pomocí proměnné

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

První příkaz pomocí rutiny Get-CMGlobalCondition získejte globální podmínku s názvem CPU speed a uložte ji do $CMGC proměnné.

Druhý příkaz odebere obor zabezpečení s názvem Scope22 z globální podmínky uložené v $CMGC proměnné.

PARAMETERS

-AssemblyName

Určuje název sestavení, pro které chcete hledat. Název sestavení musí být zaregistrován v globální mezipaměti sestavení (GAC).

Type: String
Parameter Sets: SetAssembly
Aliases:

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

-Class – třída

Určuje třídu Windows Management Instrumentation (WMI) použitou k sestavení dotazu jazyk WQL (WMI Query Language) (WQL). Dotaz posuzuje dodržování předpisů na klientských počítačích.

Type: String
Parameter Sets: SetWqlQuery
Aliases:

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

-Column

Určuje název sloupce, který se použije k vyhodnocení dodržování předpisů globální podmínky.

Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-Database

Určuje název databáze. Na SQL se spustí následující dotaz.

Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:

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

-Description (Popis)

Určuje popis globální podmínky.

Type: String
Parameter Sets: SetGeneral
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistinguishedName

Určuje rozlišující název objektu služby Active Directory Domain Services (AD DS), který se má vyhodnotit pro dodržování předpisů v klientských počítačích.

Type: String
Parameter Sets: SetADQuery
Aliases:

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

-FileOrFolderName

Určuje název souboru nebo složky. Zadáním parametru IsFolder vyhledejte složku.

Type: String
Parameter Sets: SetFileSystem
Aliases:

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

-FilePath

Určuje cestu k souboru, u které podmínka vyhodnotí dodržování předpisů.

Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance, SetFileSystemFile, SetScript, SetXPathQuery
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IncludeSubfolder

Určuje, jestli rutina obsahuje podsložky operace.

Type: Boolean
Parameter Sets: SetFileSystem, SetFileSystemFile, SetXPathQuery
Aliases: IncludeSubfolders

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

-InstanceName

Určuje název instance databáze, kterou globální podmínka prohledá. Pokud chcete vyhledat výchozí instanci, zadejte parametr UseDefaultInstance. Pokud chcete prohledávat všechny instance, zadejte parametr UseAllInstances.

Type: String
Parameter Sets: SetSqlQuerySpecificInstance
Aliases:

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

-Is64Bit

Označuje, že globální podmínka hledá kromě umístění 32bitového systémového souboru také umístění 64bitového systémového souboru.

Type: Boolean
Parameter Sets: SetFileSystem, SetFileSystemFile, SetXPathQuery, SetRegistryKey, SetRegistryValue
Aliases:

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

-KeyName

Určuje název klíče registru, pro který se má hledat. Použijte formát klíč\podklíč.

Type: String
Parameter Sets: SetRegistryKey, SetRegistryValue
Aliases:

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

-LdapFilter

Určuje filtr protokolu LDAP (Lightweight Directory Access Protocol), který zpřesní výsledky dotazu služby AD DS za účelem vyhodnocení shody na klientských počítačích.

Type: String
Parameter Sets: SetADQuery
Aliases:

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

-LdapPrefix

Určuje platnou předponu protokolu LDAP pro dotaz služby AD DS, který posuzuje dodržování předpisů na klientských počítačích. Přijatelné hodnoty pro tento parametr jsou: LDAP:// nebo GC://.

Type: String
Parameter Sets: SetADQuery
Aliases:

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

-MetabázePath

Určuje cestu k souboru metabáze pro Internetová informační služba (IIS).

Type: String
Parameter Sets: SetIisMetabase
Aliases:

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

-Name

Určuje název globálních podmínek. Tato hodnota odpovídá vlastnosti LocalizedDisplayName objektu globální podmínky.

Type: String
Parameter Sets: (All)
Aliases:

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

-Namespace

Určuje obor názvů z úložiště wmi. Výchozí hodnota je Root\cimv2.

Type: String
Parameter Sets: SetWqlQuery
Aliases:

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

-NewName

Určuje nový název globální podmínky.

Type: String
Parameter Sets: SetGeneral
Aliases:

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

-OmaUri

Určuje identifikátor URI (Uniform Resource Indicator), který odkazuje na parametry zařízení OMA (Open Mobile Alliance).

Type: String
Parameter Sets: SetOmaUri
Aliases:

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

-PassThru

Vrátí aktuální pracovní objekt. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Určuje cestu pro identifikátor URI OMA.

Type: String
Parameter Sets: SetFileSystem
Aliases:

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

-Property

Určuje vlastnost objektu služby AD DS, který se používá k vyhodnocení dodržování předpisů v klientských počítačích.

Type: String
Parameter Sets: SetWqlQuery, SetADQuery
Aliases:

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

-PropertyId

Určuje vlastnost služby AD DS, kterou Správce konfigurace k určení kompatibility klienta.

Type: String
Parameter Sets: SetIisMetabase
Aliases:

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

-RegistryHive

Určuje kořenový klíč v registru, který identifikuje hledaný podregistr registru. WMI používá podregistr registru k vrácení, nastavení a změně hodnot klíčů registru. Tento parametr přijímá tyto hodnoty:

  • Kořenová třída
  • CurrentConfig
  • Currentuser
  • Místní počítač
  • Uživatelé
Type: RegistryRootKey
Parameter Sets: SetRegistryKey, SetRegistryValue
Aliases:
Accepted values: ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users

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

-ScriptLanguage

Určuje skriptovací jazyk, který se má použít. Tento parametr přijímá tyto hodnoty:

  • PowerShell
  • VBScript
  • JScript
Type: ScriptingLanguage
Parameter Sets: SetScript
Aliases:
Accepted values: PowerShell, VBScript, JScript, ShellScript

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

-SearchScope

Určuje obor vyhledávání ve službě AD DS. Tento parametr přijímá tyto hodnoty:

  • Základ
  • Jedna úroveň
  • Podstrom
Type: SearchScope
Parameter Sets: SetADQuery
Aliases:
Accepted values: Base, OneLevel, Subtree

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

-Use32BitHost

Označuje, že soubor nebo složka jsou přidruženy k 64bitové aplikaci.

Type: Boolean
Parameter Sets: SetScript
Aliases:

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

-UseAllInstances

Označuje, že globální podmínka prohledá všechny instance databáze. Pokud chcete vyhledat pojmenovanou instanci, zadejte parametr InstanceName. Pokud chcete vyhledat výchozí instanci, zadejte parametr UseDefaultInstance.

Type: SwitchParameter
Parameter Sets: SetSqlQueryAllInstances
Aliases:

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

-UseDefaultInstance

Označuje, že globální podmínka prohledá výchozí instanci databáze. Pokud chcete vyhledat pojmenovanou instanci, zadejte parametr InstanceName. Pokud chcete prohledávat všechny instance, zadejte parametr UseAllInstances.

Type: SwitchParameter
Parameter Sets: SetSqlQueryDefaultInstance
Aliases:

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

-UseLoggedOnUserCredential

Určuje, jestli se mají použít přihlašovací údaje přihlášeného uživatele.

Type: Boolean
Parameter Sets: SetScript
Aliases: UseLoggedOnUserCredentials

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

-ValueName

Určuje hodnotu, která má být obsažena v zadaném klíči registru.

Type: String
Parameter Sets: SetRegistryValue
Aliases:

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-WhereClause

Určuje klauzuli WHERE dotazu jazyka WQL, která se použije na zadaný obor názvů, třídu a vlastnost na klientských počítačích.

Type: String
Parameter Sets: SetWqlQuery
Aliases:

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

-XPathQuery

Určuje dotaz XPath.

Type: String
Parameter Sets: SetXPathQuery
Aliases:

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

-XmlFilePath

Určuje soubor, který obsahuje dotaz XML, který se má použít k vyhodnocení dodržování předpisů v klientských počítačích.

Type: String
Parameter Sets: SetXPathQuery
Aliases:

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

-XmlNamespace

Určuje pole platných úplných dotazů jazyka XPath (XML Path Language), které se mají použít k vyhodnocení dodržování předpisů v klientských počítačích.

Type: String[]
Parameter Sets: SetXPathQuery
Aliases: XmlNamespaces

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Žádná

OUTPUTS

System.Object

POZNÁMKY

New-CMGlobalCondition

Get-CMGlobalCondition

Remove-CMGlobalCondition

Set-CMGlobalCondition

Set-CMGlobalConditionAssembly

Set-CMGlobalConditionFile

Set-CMGlobalConditionIisMetabase

Set-CMGlobalConditionOmaUri

Set-CMGlobalConditionRegistryKey

Set-CMGlobalConditionRegistryValue

Set-CMGlobalConditionScript

Set-CMGlobalConditionSqlQuery

Set-CMGlobalConditionWqlQuery

Set-CMGlobalConditionXPathQuery