New-CMGlobalCondition
SYNOPSIS
Cria um objeto de condição global do Gestor de Configuração.
SYNTAX
NewADQuery (Padrão)
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>]
Nova Assembleia
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>]
Base de NewiisMeta
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>]
NovoScript
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
O cmdlet New-CMGlobalCondition cria uma condição global no Gestor de Configuração.
Uma condição global é uma configuração ou expressão no Gestor de Configuração que pode usar para especificar como o Gestor de Configuração fornece e implementa uma aplicação aos clientes.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Criar uma condição global
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows
Este comando cria uma condição global que procura o conjunto chamado Microsoft. Office. Tools.Word.v9.0 em Windows dispositivos.
PARAMETERS
-AllInstances
Indica que a condição global procura todas as situações de base de dados. Para pesquisar uma instância nomeada, especifique o parâmetro CasoName. Para pesquisar a instância padrão, especifique o parâmetro UseDefaultInstance.
Type: SwitchParameter
Parameter Sets: NewSqlQueryAllInstances
Aliases: UseAllInstances
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome da assembléia
Especifica o nome de um conjunto para o qual procurar. Um nome de montagem deve ser registado na Cache de Montagem Global.
Type: String
Parameter Sets: NewAssembly
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Classe
Especifica uma classe de instrumentação de gestão de Windows (WMI) usada para construir uma consulta de Idioma de Consulta WMI (WQL). A consulta avalia a conformidade nos computadores clientes.
Type: String
Parameter Sets: NewWqlQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Coluna
Especifica o nome da coluna usado para avaliar a conformidade da condição global.
Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DataType
Especifica o tipo global de dados de condição. Os valores aceitáveis para este parâmetro são:
- Booleano
- DateTime
- FloatingPoint
- Número inteiro
- InteiroArray
- String
- CadeiaArray
- Versão
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
-Base de dados
Especifica o nome de uma base de dados. A consulta SQL é nesta base de dados.
Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PadrãoInstância
Indica que a condição global procura a instância de base de dados padrão. Para pesquisar uma instância nomeada, especifique o parâmetro CasoName. Para pesquisar todas as instâncias, especifique o parâmetro UseAllInstances.
Type: SwitchParameter
Parameter Sets: NewSqlQueryDefaultInstance
Aliases: UseDefaultInstance
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifica uma descrição para a condição global.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DispositivoType
Especifica o tipo de dispositivo ao qual esta condição global se aplica. Os valores aceitáveis para este parâmetro são: Nokia, Windows e 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
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome distinto
Especifica o nome distinto do objeto Ative Directory Domain Services (AD DS) para avaliar a conformidade nos computadores clientes.
Type: String
Parameter Sets: NewADQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FileOrFolderName
Especifica o nome de um ficheiro ou pasta. Especifique o parâmetro IsFolder para procurar uma pasta.
Type: String
Parameter Sets: NewFileSystem
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- FilePath
Especifica um caminho de arquivo para o ficheiro que a condição avalia para conformidade.
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
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Incluir O Menor
Indica se o cmdlet inclui sub-dobradres na operação.
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
-Nome de instância
Especifica o nome de uma instância de base de dados que a condição global procura. Para pesquisar a instância padrão, especifique o parâmetro UseDefaultInstance. Para pesquisar todas as instâncias, especifique o parâmetro UseAllInstances.
Type: String
Parameter Sets: NewSqlQuerySpecificInstance
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Is64Bit
Indica que a condição global procura a localização do ficheiro do sistema de 64 bits, além da localização do ficheiro do sistema de 32 bits.
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
Indica que a condição global procura uma pasta. Se não selecionar este parâmetro, a condição procura um ficheiro. Especifique o nome do ficheiro ou pasta utilizando o parâmetro FileOrFolderName.
Type: SwitchParameter
Parameter Sets: NewFileSystem
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome-chave
Especifica o nome chave do registo para o qual procurar. Utilize o formato key\subkey.
Type: String
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LdapFilter
Especifica um filtro lightweight diretório de acesso ao diretório (LDAP) para refinar os resultados da consulta AD DS para avaliar a conformidade nos computadores clientes.
Type: String
Parameter Sets: NewADQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LdapPrefix
Especifica um prefixo LDAP válido para a consulta DS AD que avalia a conformidade nos computadores clientes. Este prefixo pode ser LDAP:// ou GC://.
Type: String
Parameter Sets: NewADQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MetabasePath
Especifica o caminho para o ficheiro metabase para Serviços de Informação Internet (IIS).
Type: String
Parameter Sets: NewIisMetabase
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica o nome de um ficheiro de metabase IIS.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- Espaço de nome
Especifica um espaço de nome de um repositório de WMI. O valor predefinido é Root\cimv2.
Type: String
Parameter Sets: NewWqlQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OmaUri
Especifica um Indicador uniforme de Recursos (URI) que aponta para parâmetros específicos do dispositivo para um dispositivo 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
Especifica o caminho para um OMA URI.
Type: String
Parameter Sets: NewFileSystem
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Propriedade
Especifica a propriedade do objeto DS AD usado para avaliar a conformidade nos computadores clientes.
Type: String
Parameter Sets: NewADQuery, NewWqlQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PropertyId
Especifica a propriedade da DS AD que o Gestor de Configuração utiliza para determinar a conformidade do cliente.
Type: String
Parameter Sets: NewIisMetabase
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RegistryHive
Especifica a chave raiz no registo que identifica a colmeia de registo que procura. O WMI utiliza a colmeia de registo para devolver, definir e alterar os valores das chaves de registo. Os valores aceitáveis para este parâmetro são:
- ClassesRoot
- Config atual
- ActualUser
- Barata local
- Utilizadores
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
Especifica uma linguagem de script para usar. Os valores aceitáveis para este parâmetro são:
- 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
Especifica o âmbito de pesquisa em DS AD. Os valores aceitáveis para este parâmetro são: Base, OneLevel e 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
Indica que o ficheiro ou a pasta estão associados a uma aplicação de 64 bits.
Type: Boolean
Parameter Sets: NewScript
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseLoggedOnUserCredential
Indica se deve utilizar as credenciais do utilizador.
Type: Boolean
Parameter Sets: NewScript
Aliases: UseLoggedOnUserCredentials
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValorName
Especifica o valor a conter na chave de registo especificada.
Type: String
Parameter Sets: NewRegistryValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
- Onde AClause
Especifica uma consulta WQL ONDE cláusula para aplicar ao espaço de nome, classe e propriedade especificados em computadores clientes.
Type: String
Parameter Sets: NewWqlQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-XPathQuery
Especifica uma consulta XPath.
Type: String
Parameter Sets: NewXPathQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-XmlFilePath
Especifica um ficheiro que contém a consulta XML para utilizar para avaliar a conformidade nos computadores clientes.
Type: String
Parameter Sets: NewXPathQueryFromFile
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-XmlNamespace
Especifica uma série de consultas válidas e completas de idioma de caminho XML (XPath) para avaliar a conformidade nos computadores clientes.
Type: String[]
Parameter Sets: NewXPathQuery, NewXPathQueryFromFile
Aliases: XmlNamespaces
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.