New-CMUserCollection
SYNOPSIS
Cria uma coleção para utilizadores e adiciona a coleção à hierarquia do Gestor de Configuração.
SYNTAX
ByName (Padrão)
New-CMUserCollection [-Comment <String>] -LimitingCollectionName <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMUserCollection [-Comment <String>] -InputObject <IResultObject> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMUserCollection [-Comment <String>] -LimitingCollectionId <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
O cmdlet New-CMUserCollection cria uma coleção baseada numa coleção específica de limitação. A recolha limitativa determina quais os utilizadores que podem ser membros da coleção de utilizadores que cria. Por exemplo, quando utiliza a coleção All Users como a coleção limitativa, a nova coleção pode incluir qualquer utilizador na hierarquia do Gestor de Configuração. Especifica a coleção limitativa fornecendo o seu nome ou ID.
Os utilizadores são adicionados à coleção pelas regras de adesão. Para adicionar membros à recolha do utilizador utilize uma das seguintes regras de adesão:
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
As coleções representam agrupamentos lógicos de recursos, como utilizadores e dispositivos. Para obter mais informações sobre as coleções do Gestor de Configuração, 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: Criar uma coleção de utilizadores
PS XYZ:\> New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
Este comando cria uma coleção para todos os utilizadores do departamento de Vendas. Especificar todos os utilizadores para o parâmetro LimitingCollectionName indica que a nova coleção pode incluir qualquer utilizador na hierarquia do Gestor de Configuração.
PARAMETERS
-Comentário
Type: String
Parameter Sets: (All)
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
-InputObject
Especifica a entrada para este cmdlet. Pode utilizar este parâmetro ou canalizar a entrada para este cmdlet.
Type: IResultObject
Parameter Sets: ByValue
Aliases: LimitingCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-LimitingCollectionId
Type: String
Parameter Sets: ById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Limitação Do Nome deCollection
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Type: CollectionRefreshType
Parameter Sets: (All)
Aliases:
Accepted values: None, Manual, Periodic, Continuous, Both
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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
Sistema.Objeto
NOTAS
RELATED LINKS
Add-CMDeviceCollectionQueryMembershipRule
Add-CMUserCollectionDirectMembershipRule
Add-CMUserCollectionExcludeMembershipRule