New-CMGlobalCondition

SYNOPSIS

Tworzy obiekt Menedżer konfiguracji warunku globalnego.

SYNTAX

NewADQuery (ustawienie domyślne)

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -DistinguishedName <String> -LdapFilter <String>
 [-LdapPrefix <String>] -Name <String> -Property <String> -SearchScope <SearchScope> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewSqlQueryAllInstances

New-CMGlobalCondition [-AllInstances] -Column <String> -Database <String> -DataType <GlobalConditionDataType>
 [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String> -Name <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

Nowyassembly

New-CMGlobalCondition -AssemblyName <String> [-Description <String>] -DeviceType <GlobalConditionDeviceType>
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewWqlQuery

New-CMGlobalCondition -Class <String> -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -Name <String> [-Namespace <String>] -Property <String>
 [-WhereClause <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

NewSqlQueryDefaultInstance

New-CMGlobalCondition -Column <String> -Database <String> -DataType <GlobalConditionDataType>
 [-DefaultInstance] [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String>
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewSqlQuerySpecificInstance

New-CMGlobalCondition -Column <String> -Database <String> -DataType <GlobalConditionDataType>
 [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String> -InstanceName <String>
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewIisMetabase

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> [-MetabasePath <String>] -Name <String> -PropertyId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewRegistryValue

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> [-Is64Bit <Boolean>] -KeyName <String> -Name <String>
 -RegistryHive <RegistryRootKey> -ValueName <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

NewScript

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -FilePath <String> -Name <String> -ScriptLanguage <ScriptingLanguage>
 [-Use32BitHost <Boolean>] [-UseLoggedOnUserCredential <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewXPathQuery

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -FilePath <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
 -Name <String> [-XmlNamespace <String[]>] -XPathQuery <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewXPathQueryFromFile

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -FilePath <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
 -Name <String> -XmlFilePath <String> [-XmlNamespace <String[]>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewOmaUri

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -Name <String> -OmaUri <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewFileSystem

New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType>
 -FileOrFolderName <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] [-IsFolder] -Name <String>
 -Path <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewFileSystemFile

New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String>
 [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewRegistryKey

New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType> [-Is64Bit <Boolean>]
 -KeyName <String> -Name <String> -RegistryHive <RegistryRootKey> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Polecenie cmdlet New-CMGlobalCondition tworzy warunek globalny w Menedżer konfiguracji.

Warunek globalny to ustawienie lub wyrażenie w Menedżer konfiguracji, które umożliwia określenie sposobu Menedżer konfiguracji i wdrażania aplikacji na klientach.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Tworzenie warunku globalnego

PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows

To polecenie tworzy warunek globalny, który wyszukuje zestaw o nazwie Microsoft. Office. Tools.Word.v9.0 na Windows urządzeniach.

PARAMETERS

-AllInstances

Wskazuje, że warunek globalny wyszukuje wszystkie wystąpienia bazy danych. Aby przeszukać nazwane wystąpienie, określ parametr InstanceName. Aby przeszukać wystąpienie domyślne, określ parametr UseDefaultInstance.

Type: SwitchParameter
Parameter Sets: NewSqlQueryAllInstances
Aliases: UseAllInstances

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

-AssemblyName

Określa nazwę zestawu, dla którego ma być wyszukiwany. Nazwa zestawu musi być zarejestrowana w globalnej pamięci podręcznej zestawów.

Type: String
Parameter Sets: NewAssembly
Aliases:

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

-Class (Klasa)

Określa klasę Windows Management Instrumentation (WMI) używaną do tworzenia zapytania język zapytań usługi WMI (WQL). Zapytanie ocenia zgodność na komputerach klienckich.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

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

-Column (Kolumna)

Określa nazwę kolumny używaną do oceny zgodności warunku globalnego.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DataType

Określa typ danych warunku globalnego. Dopuszczalne wartości dla tego parametru to:

  • Boolean (wartość logiczna)
  • Data/godzina
  • Zmiennoprzecinkowy
  • Liczba całkowita
  • IntegerArray
  • Ciąg
  • StringArray
  • Wersja
Type: GlobalConditionDataType
Parameter Sets: NewADQuery, NewSqlQueryAllInstances, NewWqlQuery, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance, NewIisMetabase, NewRegistryValue, NewScript, NewXPathQuery, NewXPathQueryFromFile, NewOmaUri
Aliases:
Accepted values: String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml

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

-Database (Baza danych)

Określa nazwę bazy danych. Zapytanie SQL jest uruchamiane w tej bazie danych.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:

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

-DefaultInstance

Wskazuje, że warunek globalny wyszukuje domyślne wystąpienie bazy danych. Aby przeszukać nazwane wystąpienie, określ parametr InstanceName. Aby przeszukać wszystkie wystąpienia, określ parametr UseAllInstances.

Type: SwitchParameter
Parameter Sets: NewSqlQueryDefaultInstance
Aliases: UseDefaultInstance

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

-Description (Opis)

Określa opis warunku globalnego.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeviceType

Określa typ urządzenia, do którego ma zastosowanie ten warunek globalny. Dopuszczalne wartości dla tego parametru to: Nokia, Windows i WindowsMobile.

Type: GlobalConditionDeviceType
Parameter Sets: (All)
Aliases:
Accepted values: Windows, WindowsMobile

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistinguishedName

Określa nazwę wyróżniającą obiektu Active Directory Domain Services (AD DS) do oceny zgodności na komputerach klienckich.

Type: String
Parameter Sets: NewADQuery
Aliases:

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

-FileOrFolderName

Określa nazwę pliku lub folderu. Określ parametr IsFolder, aby wyszukać folder.

Type: String
Parameter Sets: NewFileSystem
Aliases:

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

-FilePath

Określa ścieżkę pliku, który zostanie oceniony przez warunek zgodności.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance, NewScript, NewXPathQuery, NewXPathQueryFromFile, NewFileSystemFile
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IncludeSubfolder

Wskazuje, czy polecenie cmdlet zawiera podfoldery w operacji.

Type: Boolean
Parameter Sets: NewXPathQuery, NewXPathQueryFromFile, NewFileSystem, NewFileSystemFile
Aliases: IncludeSubfolders

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

-InstanceName

Określa nazwę wystąpienia bazy danych wyszukiwany przez warunek globalny. Aby przeszukać wystąpienie domyślne, określ parametr UseDefaultInstance. Aby przeszukać wszystkie wystąpienia, określ parametr UseAllInstances.

Type: String
Parameter Sets: NewSqlQuerySpecificInstance
Aliases:

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

-Is64Bit

Wskazuje, że warunek globalny oprócz 32-bitowej lokalizacji plików systemowych wyszukuje 64-bitową lokalizację pliku systemowego.

Type: Boolean
Parameter Sets: NewRegistryValue, NewXPathQuery, NewXPathQueryFromFile, NewFileSystem, NewFileSystemFile, NewRegistryKey
Aliases:

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

-IsFolder

Wskazuje, że warunek globalny wyszukuje folder. Jeśli nie wybierzesz tego parametru, warunek wyszukuje plik. Określ nazwę pliku lub folderu przy użyciu parametru FileOrFolderName.

Type: SwitchParameter
Parameter Sets: NewFileSystem
Aliases:

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

-KeyName

Określa nazwę klucza rejestru, dla którego ma być wyszukiwany. Użyj formatu klucz\podklucz.

Type: String
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:

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

-LdapFilter

Określa filtr Lightweight Directory Access Protocol (LDAP), aby uściślić wyniki zapytania AD DS w celu oceny zgodności na komputerach klienckich.

Type: String
Parameter Sets: NewADQuery
Aliases:

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

-LdapPrefix

Określa prawidłowy prefiks LDAP dla zapytania AD DS, które ocenia zgodność na komputerach klienckich. Ten prefiks może być LDAP:// lub GC://.

Type: String
Parameter Sets: NewADQuery
Aliases:

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

-MetabasePath

Określa ścieżkę do pliku metabazy dla Internet Information Services (IIS).

Type: String
Parameter Sets: NewIisMetabase
Aliases:

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

-Name

Określa nazwę pliku metabazy usług IIS.

Type: String
Parameter Sets: (All)
Aliases:

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

-Przestrzeń nazw

Określa przestrzeń nazw z repozytorium usługi WMI. Wartość domyślna to Root\cimv2.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

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

-OmaUri

Określa jednolity wskaźnik zasobów (URI, Uniform Resource Indicator), który wskazuje parametry specyficzne dla urządzenia dla urządzenia Open Mobile Alliance (OMA).

Type: String
Parameter Sets: NewOmaUri
Aliases:

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

-Path

Określa ścieżkę dla URI OMA.

Type: String
Parameter Sets: NewFileSystem
Aliases:

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

-Właściwość

Określa właściwość obiektu AD DS używanego do oceny zgodności na komputerach klienckich.

Type: String
Parameter Sets: NewADQuery, NewWqlQuery
Aliases:

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

-PropertyId

Określa właściwość usługi AD DS, Menedżer konfiguracji służy do określania zgodności klienta.

Type: String
Parameter Sets: NewIisMetabase
Aliases:

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

-RegistryHive

Określa klucz główny w rejestrze, który identyfikuje wyszukiwany gałąź rejestru. WMI używa gałęzi rejestru, aby zwracać, ustawiać i zmieniać wartości kluczy rejestru. Dopuszczalne wartości dla tego parametru to:

  • ClassesRoot
  • CurrentConfig
  • Currentuser
  • Localmachine
  • Użytkownicy
Type: RegistryRootKey
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:
Accepted values: ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users

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

-ScriptLanguage

Określa język skryptów do użycia. Dopuszczalne wartości dla tego parametru to:

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

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

-SearchScope

Określa zakres wyszukiwania w AD DS. Dopuszczalne wartości dla tego parametru to: Base, OneLevel i Subtree.

Type: SearchScope
Parameter Sets: NewADQuery
Aliases:
Accepted values: Base, OneLevel, Subtree

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

-Use32BitHost

Wskazuje, że plik lub folder jest skojarzony z aplikacją 64-bitową.

Type: Boolean
Parameter Sets: NewScript
Aliases:

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

-UseLoggedOnUserCredential

Wskazuje, czy należy używać poświadczeń zalogowanego użytkownika.

Type: Boolean
Parameter Sets: NewScript
Aliases: UseLoggedOnUserCredentials

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

-ValueName

Określa wartość, która ma być zawarta w określonym kluczu rejestru.

Type: String
Parameter Sets: NewRegistryValue
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

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

-WhereClause

Określa klauzulę WHERE zapytania WQL do zastosowania do określonej przestrzeni nazw, klasy i właściwości na komputerach klienckich.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

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

-XPathQuery

Określa zapytanie XPath.

Type: String
Parameter Sets: NewXPathQuery
Aliases:

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

-XmlFilePath

Określa plik, który zawiera zapytanie XML do użycia do oceny zgodności na komputerach klienckich.

Type: String
Parameter Sets: NewXPathQueryFromFile
Aliases:

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

-XmlNamespace

Określa tablicę prawidłowych, pełnych zapytań języka ścieżki XML (XPath) do użycia w celu oceny zgodności na komputerach klienckich.

Type: String[]
Parameter Sets: NewXPathQuery, NewXPathQueryFromFile
Aliases: XmlNamespaces

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_GlobalCondition

UWAGI

Get-CMGlobalCondition

Set-CMGlobalCondition

Remove-CMGlobalCondition