Add-CMUserCollectionQueryMembershipRule
SYNOPSIS
Adiciona uma regra de adesão de consulta a uma ou mais coleções de utilizadores do Gestor de Configuração.
SYNTAX
ByCollectionValue (Padrão)
Add-CMUserCollectionQueryMembershipRule -InputObject <IResultObject> [-PassThru] -QueryExpression <String>
-RuleName <String> [-ValidateQueryHasResult] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
ByCollectionId
Add-CMUserCollectionQueryMembershipRule -CollectionId <String> [-PassThru] -QueryExpression <String>
-RuleName <String> [-ValidateQueryHasResult] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
ByCollectionName
Add-CMUserCollectionQueryMembershipRule -CollectionName <String> [-PassThru] -QueryExpression <String>
-RuleName <String> [-ValidateQueryHasResult] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
O Add-CMUserCollectionQueryMembershipRule cmdlet adiciona uma regra que adiciona os utilizadores às coleções com base numa consulta no Gestor de Configuração. Pode especificar as coleções de utilizador utilizando os seus nomes, IDs ou especificando um objeto que represente as coleções. A consulta é especificada como uma cadeia de texto.
Uma regra de consulta permite-lhe atualizar dinamicamente os membros de uma coleção com base numa consulta que é executada num horário. Para obter mais informações sobre as regras de recolha, consulte Introdução às Coleções no Gestor de Configuração.
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 uma regra a uma coleção usando um nome
PS XYZ:\>Add-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -QueryExpression "select SMS_R_USER.ResourceID,SMS_R_USER.ResourceType,SMS_R_USER.Name,SMS_R_USER.UniqueUserName,SMS_R_USER.WindowsNTDomain from SMS_R_User" -RuleName "Remote Users by Domain"
Este comando adiciona uma regra chamada Utilizadores Remotos por Domínio à coleção denominada Utilizadores Remotos. O comando especifica a consulta como uma corda.
PARAMETERS
-CollectionId
Especifica o ID da coleção do utilizador onde a regra é aplicada.
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifica o nome da coleção de utilizadores onde a regra é aplicada.
Type: String
Parameter Sets: ByCollectionName
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
-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
-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
-InputObject
{{ Preencha a descrição do serviço de entrada}}
Type: IResultObject
Parameter Sets: ByCollectionValue
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-QueryExpressão
Especifica a expressão de consulta que o Gestor de Configuração utiliza para atualizar as coleções do utilizador.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RegraName
Especifica o nome para a regra.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValidarQueryHasResult
{{ Preencha validarQueryHasResult Descrição }}
Type: SwitchParameter
Parameter Sets: (All)
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 comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
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.