Set-CMGlobalCondition
Modifica as definições de uma condição global do Configuration Manager.
Sintaxe
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>]
Description
O cmdlet Set-CMGlobalCondition modifica as definições para uma condição global. Pode adicionar ou remover um âmbito de segurança para uma condição global. Pode especificar uma condição global por nome ou ID ou utilizar o cmdlet Get-CMGlobalCondition para obter um objeto de condição global.
O Configuration Manager utiliza condições globais para representar condições empresariais ou técnicas. As condições globais especificam como fornecer e implementar aplicações em dispositivos cliente.
Cada condição global tem de ter, pelo menos, um âmbito de segurança.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Adicionar um âmbito de segurança
PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"
Este comando adiciona o âmbito de segurança denominado Scope22 à condição global denominada velocidade da CPU.
Exemplo 2: Remover um âmbito de segurança com uma variável
PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"
O primeiro comando utiliza o cmdlet Get-CMGlobalCondition para obter a condição global denominada velocidade da CPU e armazená-la na variável $CMGC.
O segundo comando remove o âmbito de segurança denominado Scope22 da condição global armazenada na variável $CMGC.
Parâmetros
-AssemblyName
Especifica o nome de uma assemblagem para a qual pretende procurar. Tem de ser registado um nome de assemblagem na cache de assemblagem global.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Class
Especifica uma classe Windows Management Instrumentation (WMI) utilizada para criar uma consulta WMI Query Language (WQL). A consulta avalia a compatibilidade em computadores cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Column
Especifica o nome da coluna utilizado para avaliar a conformidade da condição global.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Database
Especifica o nome de uma base de dados. A consulta SQL é executada nesta base de dados.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Description
Especifica uma descrição para a condição global.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DistinguishedName
Especifica o nome único do objeto dos Serviços de Domínio do Active Directory (AD DS) para avaliar a compatibilidade em computadores cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-FileOrFolderName
Especifica o nome de um ficheiro ou pasta. Especifique o parâmetro IsFolder para procurar uma pasta.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-FilePath
Especifica um caminho de ficheiro para o ficheiro que a condição avalia relativamente à compatibilidade.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IncludeSubfolder
Indica se o cmdlet inclui subpastas na operação.
Tipo: | Boolean |
Aliases: | IncludeSubfolders |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InstanceName
Especifica o nome de uma instância de base de dados que a condição global procura. Para procurar a instância predefinida, especifique o parâmetro UseDefaultInstance . Para procurar em todas as instâncias, especifique o parâmetro UseAllInstances .
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Is64Bit
Indica que a condição global procura na localização do ficheiro do sistema de 64 bits, além da localização do ficheiro de sistema de 32 bits.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-KeyName
Especifica o nome da chave de registo para o qual pretende procurar. Utilize a chave de formato\subchave.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-LdapFilter
Especifica um filtro LDAP (Lightweight Directory Access Protocol) para refinar os resultados da consulta do AD DS para avaliar a compatibilidade em computadores cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-LdapPrefix
Especifica um prefixo LDAP válido para a consulta do AD DS que avalia a conformidade em computadores cliente. Os valores aceitáveis para este parâmetro são: LDAP:// ou GC://.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MetabasePath
Especifica o caminho para o ficheiro metabase dos Serviços de Informação Internet (IIS).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifica o nome das condições globais. Este valor corresponde à propriedade LocalizedDisplayName de um objeto de condição global.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Namespace
Especifica um espaço de nomes de um repositório WMI. O valor predefinido é Root\cimv2.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-NewName
Especifica um novo nome para a condição global.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-OmaUri
Especifica um Indicador de Recursos Uniformes (URI) que aponta para parâmetros específicos do dispositivo para um dispositivo Open Mobile Alliance (OMA).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PassThru
Devolve o objeto de trabalho atual. Por padrão, esse cmdlet não gera saída.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Path
Especifica o caminho para um URI OMA.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Property
Especifica a propriedade do objeto do AD DS utilizado para avaliar a compatibilidade em computadores cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PropertyId
Especifica a propriedade do AD DS que o Configuration Manager utiliza para determinar a conformidade do cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RegistryHive
Especifica a chave raiz no registo que identifica o ramo de registo que procura. O WMI utiliza o ramo de registo para devolver, definir e alterar os valores das chaves de registo. Os valores aceitáveis para esse parâmetro são:
- ClassesRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- Usuários
Tipo: | RegistryRootKey |
Valores aceitos: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ScriptLanguage
Especifica uma linguagem de scripting a utilizar. Os valores aceitáveis para esse parâmetro são:
- PowerShell
- VBScript
- JScript
Tipo: | ScriptingLanguage |
Valores aceitos: | PowerShell, VBScript, JScript, ShellScript |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SearchScope
Especifica o âmbito de pesquisa no AD DS. Os valores aceitáveis para esse parâmetro são:
- Base
- OneLevel
- Subárvore
Tipo: | SearchScope |
Valores aceitos: | Base, OneLevel, Subtree |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Use32BitHost
Indica que o ficheiro ou pasta está associado a uma aplicação de 64 bits.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UseAllInstances
Indica que a condição global procura em todas as instâncias da base de dados. Para procurar uma instância nomeada, especifique o parâmetro InstanceName . Para procurar a instância predefinida, especifique o parâmetro UseDefaultInstance .
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UseDefaultInstance
Indica que a condição global procura na instância de base de dados predefinida. Para procurar uma instância nomeada, especifique o parâmetro InstanceName . Para procurar em todas as instâncias, especifique o parâmetro UseAllInstances .
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UseLoggedOnUserCredential
Indica se deve utilizar credenciais de utilizador com sessão iniciada.
Tipo: | Boolean |
Aliases: | UseLoggedOnUserCredentials |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ValueName
Especifica o valor a ser contido na chave de registo especificada.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhereClause
Especifica uma cláusula WHERE de consulta WQL a aplicar ao espaço de nomes, classe e propriedade especificados em computadores cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-XmlFilePath
Especifica um ficheiro que contém a consulta XML a utilizar para avaliar a compatibilidade em computadores cliente.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-XmlNamespace
Especifica uma matriz de consultas de linguagem de caminho XPath (XPath) válidas e completas a utilizar para avaliar a compatibilidade em computadores cliente.
Tipo: | String[] |
Aliases: | XmlNamespaces |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-XPathQuery
Especifica uma consulta XPath.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
System.Object
Links Relacionados
- 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