New-CMUserCollection

Referencia

Módulo:: ConfigurationManager

Crear una colección de usuarios.

Syntax

New-CMUserCollection
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMUserCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMUserCollection
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear una colección de usuarios basada en una colección de límites específica. La colección de límites determina qué usuarios pueden ser miembros de la colección de usuarios que cree. Por ejemplo, cuando se usa la colección Todos los usuarios como colección de límites, la nueva colección puede incluir cualquier usuario en la jerarquía de Configuration Manager.

A continuación, puede agregar usuarios a la colección con reglas de pertenencia. Para agregar miembros a la colección de usuarios, use uno de los siguientes cmdlets de reglas de pertenencia:

Para obtener más información, vea How to create collections in Configuration Manager.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Crear una colección de usuarios

Este comando crea una colección para todos los usuarios del departamento de ventas. La especificación de Todos los usuarios para el parámetro LimitingCollectionName indica que la nueva colección puede incluir cualquier usuario en la jerarquía de Configuration Manager.

New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

Especifique un comentario opcional para describir e identificar esta colección.

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

-InputObject

Especifique un objeto para la colección de límites. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMUserCollection.

Type:	IResultObject
Aliases:	LimitingCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LimitingCollectionId

Especifique el identificador de la colección de limitación. Este valor es la propiedad CollectionID, por ejemplo, XYZ00012 o SMS00001 .

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

-LimitingCollectionName

Especifique el nombre de la colección de limitación.

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

-Name

Especifique el nombre de la nueva colección de usuarios.

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

-RefreshSchedule

Si establece el parámetro RefreshType en cualquiera Periodic o , use este parámetro para establecer la Both programación. Especifique un objeto de programación para cuando el sitio ejecute una actualización completa de la pertenencia a la colección. Para obtener este objeto, use el cmdlet New-CMSchedule.

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

-RefreshType

Especifique cómo se actualiza la pertenencia a la colección:

Manual(1): un administrador desencadena manualmente una actualización de pertenencia en la consola de Configuration Manager o con el cmdlet Invoke-CMCollectionUpdate.
Periodic (2): el sitio realiza una actualización completa en una programación. No usa actualizaciones incrementales. Si no especifica un tipo, este valor es el predeterminado.
Continuous (4): el sitio evalúa periódicamente nuevos recursos y, a continuación, agrega nuevos miembros. Este tipo también se conoce como actualización incremental. No hace una actualización completa en una programación.
Both (6): una combinación de ambos y , con actualizaciones incrementales y una Periodic actualización completa en una Continuous programación.

Si especifica o Periodic , use el parámetro Both RefreshSchedule para establecer la programación.

Nota

El None valor (0) es funcionalmente el mismo que Manual .

Type:	CollectionRefreshType
Accepted values:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object