Add-CMUserCollectionIncludeMembershipRule
Adicione uma regra de associação de inclusão a uma coleção de usuários.
Syntax
Add-CMUserCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para adicionar uma regra de associação de inclusão a uma coleção de usuários. Uma regra de associação de inclusão inclui os membros de outra coleção para a coleção de usuários em que a regra é aplicada.
Você não pode adicionar regras de associação a coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS
. Você pode incluir uma coleção padrão para que a ID de uma coleção incluída possa começar com SMS
.
Configuration Manager atualizará dinamicamente a associação da coleção de usuários em um agendamento se a associação da coleção incluída for alterada.
Quando você adiciona uma regra de associação de inclusão a uma coleção, os recursos podem se tornar membros da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração se aplique aos usuários da coleção incluída.
Para obter mais informações, consulte Como criar coleções no Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: adicionar uma regra de associação de inclusão
Esse comando adiciona a coleção de usuários chamada Todos os Usuários com uma regra de associação de inclusão. A regra é adicionada à coleção de usuários chamada Usuários.
Add-CMUserCollectionIncludeMembershipRule -CollectionName "Users" -IncludeCollectionName "All Users"
Parâmetros
-CollectionId
Especifique a ID da coleção de usuários para adicionar a regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012
. Como as coleções padrão não têm regras de associação, essa ID começa com o código do site e não SMS
com .
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique o nome da coleção de usuários para adicionar a regra.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollection
Especifique um objeto para a coleção incluída a ser adicionada à regra. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMUserCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionId
Especifique a ID da coleção incluída para adicionar à regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012
. Você pode incluir coleções padrão, para que esse valor possa começar com o código do site ou SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionName
Especifique o nome da coleção incluída para adicionar à regra.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto para a coleção de usuários para adicionar a regra. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMUserCollection .
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de