New-CMCollection
Crear un dispositivo o una colección de usuarios.
Syntax
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para crear un dispositivo o una colección de usuarios.
La colección de limitación determina qué recursos pueden ser miembros de la colección que cree. Por ejemplo, cuando usas la colección All Systems como colección de límites, ya que es una colección de dispositivos, la nueva colección de dispositivos puede incluir cualquier dispositivo en la jerarquía de Configuration Manager.
Para definir el ámbito del tipo de colección que cree, también puede usar los cmdlets New-CMDeviceCollection o New-CMUserCollection.
Después de crear una colección, agregue recursos a la colección con reglas de pertenencia. Para agregar miembros a la colección, use uno de los cmdlets para agregar reglas de pertenencia, por ejemplo:
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 de usuarios denominada testUser que establece la colección All Users como la colección de limitación.
New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
Ejemplo 2: Establecer la colección de límites a través de la canalización
En primer lugar, este comando usa get-CMCollection para obtener el objeto de colección All Users. A continuación, usa el operador de canalización para pasar el objeto al cmdlet New-CMCollection, que crea una colección denominada testUser. La colección de limitación de la nueva colección testUser es la colección All Users.
Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
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 |
-CollectionType
Especifique el tipo de colección que se creará. Este parámetro es funcionalmente el mismo que el uso de los cmdlets New-CMDeviceCollection o New-CMUserCollection.
Type: | CollectionType |
Accepted values: | User, Device |
Position: | Named |
Default value: | None |
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 |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
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, Get-CMDeviceCollectiono 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 |
Aliases: | LimitToCollectionId |
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 |
Aliases: | LimitToCollectionName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique el nombre de la nueva colección.
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 unaPeriodic
actualización completa en unaContinuous
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 |
-VariablePriority
Especifica un valor entero entre 1 y 9 para la prioridad de las variables de colección de dispositivos. 1
es la prioridad más baja y 9
es la más alta.
Para crear variables en una colección de dispositivos, use el cmdlet New-CMDeviceCollectionVariable.
Type: | Int32 |
Aliases: | DeviceCollectionVariablePrecedence |
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
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Collection server WMI class.
Vínculos relacionados
- Copy-CMCollection
- Export-CMCollection
- Get-CMCollection
- Get-CMCollectionMember
- Get-CMCollectionSetting
- Import-CMCollection
- Invoke-CMCollectionUpdate
- Remove-CMCollection
- Set-CMCollection
- New-CMDeviceCollectionVariable
- New-CMDeviceCollection
- New-CMUserCollection
- Cómo crear colecciones en Configuration Manager