Set-CMGlobalCondition

SYNOPSIS

Modifica as definições para uma condição global do Gestor de Configuração.

SYNTAX

Conjunto DeGereral (Padrão)

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

O cmdlet Set-CMGlobalCondition modifica as definições para uma condição global. Pode adicionar ou remover uma margem de segurança para uma condição global. Pode especificar uma condição global pelo nome ou ID, ou utilizar o cmdlet Get-CMGlobalCondition para obter um objeto de condição global.

O Gestor de Configuração utiliza condições globais para representar condições comerciais ou técnicas. As condições globais especificam como fornecer e implementar aplicações para dispositivos clientes.

Cada condição global deve ter pelo menos um âmbito de segurança.

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: 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 chamado Scope22 à condição global chamada velocidade CPU.

Exemplo 2: Remover um âmbito de segurança utilizando 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 chamada velocidade CPU e armazená-la na variável $CMGC.

O segundo comando remove o âmbito de segurança chamado Scope22 da condição global armazenada na variável $CMGC.

PARAMETERS

-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: SetAssembly
Aliases:

Required: False
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: SetWqlQuery
Aliases:

Required: False
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: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:

Required: False
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

-Base de dados

Especifica o nome de uma base de dados. A consulta SQL é nesta base de dados.

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

Required: False
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: SetGeneral
Aliases:

Required: False
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: SetADQuery
Aliases:

Required: False
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: SetFileSystem
Aliases:

Required: False
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: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance, SetFileSystemFile, SetScript, SetXPathQuery
Aliases:

Required: False
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: SetFileSystem, SetFileSystemFile, SetXPathQuery
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: SetSqlQuerySpecificInstance
Aliases:

Required: False
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: SetFileSystem, SetFileSystemFile, SetXPathQuery, SetRegistryKey, SetRegistryValue
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: SetRegistryKey, SetRegistryValue
Aliases:

Required: False
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: SetADQuery
Aliases:

Required: False
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. Os valores aceitáveis para este parâmetro são: LDAP:// ou GC://.

Type: String
Parameter Sets: SetADQuery
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: SetIisMetabase
Aliases:

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

-Name

Especifica o nome das condições globais. Este valor corresponde à propriedade LocalDisplayName de um objeto de condição global.

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: SetWqlQuery
Aliases:

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

-Novo Nome

Especifica um novo nome para a condição global.

Type: String
Parameter Sets: SetGeneral
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: SetOmaUri
Aliases:

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

- PassThru

Devolve o objeto de trabalho atual. Por predefinição, este cmdlet não gera quaisquer dados.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
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: SetFileSystem
Aliases:

Required: False
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: SetWqlQuery, SetADQuery
Aliases:

Required: False
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: SetIisMetabase
Aliases:

Required: False
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: 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

Especifica uma linguagem de script para usar. Os valores aceitáveis para este parâmetro são:

• 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

Especifica o âmbito de pesquisa em DS AD. Os valores aceitáveis para este parâmetro são:

• Base
• OneLevel
• Subtree

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

Indica que o ficheiro ou a pasta estão associados a uma aplicação de 64 bits.

Type: Boolean
Parameter Sets: SetScript
Aliases:

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

-UseAllInstances

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: SetSqlQueryAllInstances
Aliases:

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

-UseDefaultInstance

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: SetSqlQueryDefaultInstance
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: SetScript
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: SetRegistryValue
Aliases:

Required: False
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: SetWqlQuery
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: SetXPathQuery
Aliases:

Required: False
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: SetXPathQuery
Aliases:

Required: False
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: SetXPathQuery
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.

INPUTS

Nenhuma

OUTPUTS

Sistema.Objeto

NOTAS

RELATED LINKS

Nova CmGlobalCondição

Obter-CMGlobalCondição

Remoção-CMGlobalCondição

Conjunto-CMGlobalCondição

Conjunto-CMGlobalConditionAssembly

Set-CMGlobalConditionFile

Set-CMGlobalConditioniisMetabase

Set-CMGlobalConditionOmaUri

Set-CMGlobalConditionRegistryKey

Valor-CMGlobalConditionRegistryValue

Set-CMGlobalConditionScript

Set-CMGlobalConditionSqlQuery

Set-CMGlobalConditionWqlQuery

Set-CMGlobalConditionXPathQuery