Set-CMCollection
Configure un dispositivo o una colección de usuarios.
Sintaxis
Set-CMCollection
[-Comment <String>]
-InputObject <IResultObject>
[-LimitingCollection <IResultObject>]
[-LimitingCollectionId <String>]
[-LimitingCollectionName <String>]
[-NewName <String>]
[-PassThru]
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMCollection
-CollectionId <String>
[-Comment <String>]
[-LimitingCollection <IResultObject>]
[-LimitingCollectionId <String>]
[-LimitingCollectionName <String>]
[-NewName <String>]
[-PassThru]
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMCollection
[-Comment <String>]
[-LimitingCollection <IResultObject>]
[-LimitingCollectionId <String>]
[-LimitingCollectionName <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para configurar un dispositivo o una colección de usuarios.
La colección de limitación determina qué recursos pueden ser miembros de la colección. Por ejemplo, cuando se usa la colección All Systems como recopilación de limitación, la nueva colección puede incluir cualquier dispositivo en la jerarquía de Configuration Manager.
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:
No se pueden configurar colecciones predeterminadas. Cualquier colección de destino debe tener un identificador que comience con el código de sitio, no SMS
.
Para obtener más información, consulte Creación de colecciones en Configuration Manager.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Cambiar el nombre de una colección
El primer comando obtiene el objeto de colección denominado testUser y lo almacena en la variable $userCollection .
El segundo comando actualiza el nombre de la colección.
$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"
Parámetros
-CollectionId
Especifique el identificador de la colección que se va a configurar. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012
. No se pueden configurar colecciones predeterminadas, por lo que este valor comienza con el código de sitio, no SMS
con .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Comment
Especifique un comentario opcional para describir e identificar esta colección.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-InputObject
Especifique un objeto de colección que se va a configurar. Para obtener este objeto, use los cmdlets Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .
Tipo: | IResultObject |
Alias: | Collection |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-LimitingCollection
Especifique un objeto para la colección de limitación. Para obtener este objeto, use los cmdlets Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .
Tipo: | IResultObject |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LimitingCollectionId
Especifique el identificador de la colección de limitación. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012
o SMS00001
.
Tipo: | String |
Alias: | LimitToCollectionId |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LimitingCollectionName
Especifique el nombre de la colección de límites.
Tipo: | String |
Alias: | LimitToCollectionName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Especifique el nombre de una colección que se va a configurar.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NewName
Especifique un nuevo nombre para la colección. Use este parámetro para cambiarle el nombre.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PassThru
Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RefreshSchedule
Si establece el parámetro RefreshType en Periodic
o Both
, use este parámetro para establecer la 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 .
Tipo: | IResultObject |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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 según 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 los nuevos recursos y, a continuación, agrega nuevos miembros. Este tipo también se conoce como actualización incremental. No realiza una actualización completa según una programación. -
Both
(6): combinación dePeriodic
yContinuous
, con actualizaciones incrementales y una actualización completa según una programación.
Si especifica o Periodic
Both
, use el parámetro RefreshSchedule para establecer la programación.
Nota:
El None
valor (0) es funcionalmente el mismo Manual
que .
Tipo: | CollectionRefreshType |
Valores aceptados: | None, Manual, Periodic, Continuous, Both |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-VariablePriority
Especifique un valor entero de 1 a 9 para la prioridad de las variables de recopilación de dispositivos.
1
es la prioridad más baja y 9
es la más alta.
Para configurar variables en una colección de dispositivos, use el cmdlet Set-CMDeviceCollectionVariable .
Para ver la prioridad de variable actual, use el cmdlet Get-CMCollectionSetting .
Tipo: | Int32 |
Alias: | DeviceCollectionVariablePrecedence |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object
Vínculos relacionados
- Copy-CMCollection
- Export-CMCollection
- Get-CMCollection
- Get-CMCollectionMember
- Get-CMCollectionSetting
- Import-CMCollection
- Invoke-CMCollectionUpdate
- New-CMCollection
- Remove-CMCollection
- Set-CMCollection
- Set-CMDeviceCollectionVariable
- Get-CMDeviceCollection
- Get-CMUserCollection
- Creación de colecciones en Configuration Manager