Set-CMCollection
Configurar uma coleção de dispositivos ou utilizadores.
Sintaxe
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
Utilize este cmdlet para configurar uma coleção de dispositivos ou utilizadores.
A coleção de limitação determina que recursos podem ser membros da coleção. Por exemplo, quando utiliza a coleção Todos os Sistemas como coleção de limitação, a nova coleção pode incluir qualquer dispositivo na hierarquia do Configuration Manager.
Adicione recursos à coleção com regras de associação. Para adicionar membros à coleção, utilize um dos cmdlets para adicionar regras de associação, por exemplo:
Não pode configurar coleções predefinidas. Qualquer coleção que tenha como destino deve ter um ID que comece com o código do site, não SMScom .
Para obter mais informações, veja Como criar coleções no Configuration Manager.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Mudar o nome de uma coleção
O primeiro comando obtém o objeto de coleção denominado testUser e armazena-o na variável $userCollection .
O segundo comando atualiza o nome da coleção.
$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"Parâmetros
-CollectionId
Especifique o ID da coleção a configurar. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Não é possível configurar coleções predefinidas, pelo que este valor começa com o código do site, não SMScom .
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Comment
Especifique um comentário opcional para descrever e identificar esta coleção.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Especifique um objeto de coleção a configurar. Para obter este objeto, utilize os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .
| Tipo: | IResultObject |
| Aliases: | Collection |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LimitingCollection
Especifique um objeto para a coleção de limitação. Para obter este objeto, utilize os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LimitingCollectionId
Especifique o ID da coleção de limitação. Este valor é a propriedade CollectionID , por exemplo, XYZ00012 ou SMS00001.
| Tipo: | String |
| Aliases: | LimitToCollectionId |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LimitingCollectionName
Especifique o nome da coleção de limitação.
| Tipo: | String |
| Aliases: | LimitToCollectionName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifique o nome de uma coleção a configurar.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NewName
Especifique um novo nome para a coleção. Utilize este parâmetro para mudar o nome do mesmo.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PassThru
Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RefreshSchedule
Se definir o parâmetro RefreshType como Periodic ou Both, utilize este parâmetro para definir a agenda. Especifique um objeto de agendamento para quando o site executar uma atualização completa da associação à coleção. Para obter este objeto, utilize o cmdlet New-CMSchedule .
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RefreshType
Especifique a forma como a associação à coleção é atualizada:
-
Manual(1): Um administrador aciona manualmente uma atualização de associação na consola do Configuration Manager ou com o cmdlet Invoke-CMCollectionUpdate . -
Periodic(2): O site efetua uma atualização completa com base numa agenda. Não utiliza atualizações incrementais. Se não especificar um tipo, este valor é a predefinição. -
Continuous(4): O site avalia periodicamente novos recursos e, em seguida, adiciona novos membros. Este tipo também é conhecido como uma atualização incremental. Não efetua uma atualização completa com base numa agenda. -
Both(6): uma combinação de ePeriodicContinuous, com atualizações incrementais e uma atualização completa com base numa agenda.
Se especificar ou PeriodicBoth, utilize o parâmetro RefreshSchedule para definir a agenda.
Observação
O None valor (0) é funcionalmente o mesmo que Manual.
| Tipo: | CollectionRefreshType |
| Valores aceitos: | None, Manual, Periodic, Continuous, Both |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VariablePriority
Especifique um valor inteiro de 1 a 9 para a prioridade das variáveis de coleção de dispositivos.
1 é a prioridade mais baixa e 9 é a mais alta.
Para configurar variáveis numa coleção de dispositivos, utilize o cmdlet Set-CMDeviceCollectionVariable .
Para ver a prioridade atual da variável, utilize o cmdlet Get-CMCollectionSetting .
| Tipo: | Int32 |
| Aliases: | DeviceCollectionVariablePrecedence |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links 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
- Como criar coleções no Configuration Manager