New-CMGlobalCondition
Cria um objeto Configuration Manager condição global.
Syntax
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>] New-CMGlobalCondition
[-AllInstances]
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-AssemblyName <String>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Class <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
[-Namespace <String>]
-Property <String>
[-WhereClause <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-DefaultInstance]
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-InstanceName <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-MetabasePath <String>]
-Name <String>
-PropertyId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-Is64Bit <Boolean>]
-KeyName <String>
-Name <String>
-RegistryHive <RegistryRootKey>
-ValueName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
-ScriptLanguage <ScriptingLanguage>
[-Use32BitHost <Boolean>]
[-UseLoggedOnUserCredential <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 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>] 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>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
-OmaUri <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FileOrFolderName <String>
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
[-IsFolder]
-Name <String>
-Path <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 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 em Configuration Manager.
Uma condição global é uma configuração ou expressão no Configuration Manager que você pode usar para especificar como Configuration Manager fornece e implanta um aplicativo para clientes.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: criar uma condição global
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $WindowsEsse comando cria uma condição global que pesquisa o assembly chamado Microsoft.Office.Tools.Word.v9.0 em dispositivos Windows.
Parâmetros
-AllInstances
Indica que a condição global pesquisa todas as instâncias de banco de dados. Para pesquisar uma instância nomeada, especifique o parâmetro InstanceName . Para pesquisar a instância padrão, especifique o parâmetro UseDefaultInstance .
| Type: | SwitchParameter |
| Aliases: | UseAllInstances |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AssemblyName
Especifica o nome de um assembly para o qual pesquisar. Um nome de assembly deve ser registrado no Cache de Assembly Global.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Class
Especifica uma classe WMI (Instrumentação de Gerenciamento do Windows) usada para criar uma consulta WQL (WMI Query Language). A consulta avalia a conformidade em computadores cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Column
Especifica o nome da coluna usado para avaliar a conformidade da condição global.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Database
Especifica o nome de um banco de dados. A consulta SQL é executada neste banco de dados.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataType
Especifica o tipo de dados de condição global. Os valores aceitáveis para esse parâmetro são:
- Boolean
- DateTime
- FloatingPoint
- Inteiro
- IntegerArray
- Cadeia de caracteres
- StringArray
- Versão
| Type: | GlobalConditionDataType |
| Accepted values: | String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultInstance
Indica que a condição global pesquisa a instância de banco de dados padrão. Para pesquisar uma instância nomeada, especifique o parâmetro InstanceName . Para pesquisar todas as instâncias, especifique o parâmetro UseAllInstances .
| Type: | SwitchParameter |
| Aliases: | UseDefaultInstance |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica uma descrição para a condição global.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceType
Especifica o tipo de dispositivo ao qual essa condição global se aplica. Os valores aceitáveis para este parâmetro são: Nokia, Windows e WindowsMobile.
| Type: | GlobalConditionDeviceType |
| Accepted values: | Windows, WindowsMobile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistinguishedName
Especifica o nome distinto do objeto Active Directory Domain Services (AD DS) para avaliar a conformidade em computadores cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileOrFolderName
Especifica o nome de um arquivo ou pasta. Especifique o parâmetro IsFolder para pesquisar uma pasta.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilePath
Especifica um caminho de arquivo para o arquivo que a condição avalia para conformidade.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeSubfolder
Indica se o cmdlet inclui subpastas na operação.
| Type: | Boolean |
| Aliases: | IncludeSubfolders |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceName
Especifica o nome de uma instância de banco de dados que a condição global pesquisa. 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 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Is64Bit
Indica que a condição global pesquisa o local do arquivo do sistema de 64 bits, além do local do arquivo do sistema de 32 bits.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsFolder
Indica que a condição global procura uma pasta. Se você não selecionar esse parâmetro, a condição procurará um arquivo. Especifique o nome do arquivo ou pasta usando o parâmetro FileOrFolderName .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-KeyName
Especifica o nome da chave do registro para o qual pesquisar. Use a chave de formato\subkey.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapFilter
Especifica um filtro LDAP (Protocolo de Acesso ao Diretório Leve) para refinar os resultados da consulta do AD DS para avaliar a conformidade em computadores cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapPrefix
Especifica um prefixo LDAP válido para a consulta do AD DS que avalia a conformidade em computadores cliente. Esse prefixo pode ser LDAP:// ou GC://.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MetabasePath
Especifica o caminho para o arquivo metabase do IIS (Serviços de Informações da Internet).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome de um arquivo de metabase do IIS.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Namespace
Especifica um namespace de um repositório WMI. O valor padrão é Root\cimv2.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OmaUri
Especifica um URI (Uniform Resource Indicator) que aponta para parâmetros específicos do dispositivo para um dispositivo OMA (Open Mobile Alliance).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica o caminho para um URI OMA.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
Especifica a propriedade do objeto AD DS usado para avaliar a conformidade em computadores cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PropertyId
Especifica a propriedade do AD DS que Configuration Manager usa para determinar a conformidade do cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryHive
Especifica a chave raiz no registro que identifica o hive do registro que você pesquisa. A WMI usa o hive do registro para retornar, definir e alterar os valores das chaves do registro. Os valores aceitáveis para esse parâmetro são:
- Classesroot
- Currentconfig
- CurrentUser
- Localmachine
- Usuários
| Type: | RegistryRootKey |
| Accepted values: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptLanguage
Especifica uma linguagem de script a ser usada. Os valores aceitáveis para esse parâmetro são:
- PowerShell
- VBScript
- JScript
| Type: | ScriptingLanguage |
| Accepted values: | PowerShell, VBScript, JScript, ShellScript |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchScope
Especifica o escopo de pesquisa no AD DS. Os valores aceitáveis para esse parâmetro são: Base, OneLevel e Subtree.
| Type: | SearchScope |
| Accepted values: | Base, OneLevel, Subtree |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Use32BitHost
Indica que o arquivo ou pasta está associado a um aplicativo de 64 bits.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseLoggedOnUserCredential
Indica se deve usar as credenciais do usuário registradas.
| Type: | Boolean |
| Aliases: | UseLoggedOnUserCredentials |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueName
Especifica o valor a ser contido na chave de registro especificada.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhereClause
Especifica uma cláusula WHERE de consulta WQL a ser aplicada ao namespace, classe e propriedade especificados em computadores cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XmlFilePath
Especifica um arquivo que contém a consulta XML a ser usada para avaliar a conformidade em computadores cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XmlNamespace
Especifica uma matriz de consultas XPath (linguagem de caminho XML) válidas e completas a serem usadas para avaliar a conformidade em computadores cliente.
| Type: | String[] |
| Aliases: | XmlNamespaces |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XPathQuery
Especifica uma consulta XPath.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
None
Saídas
IResultObject
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de