Get-CMCollectionDirectMembershipRule
Obtenha uma regra de associação direta para um dispositivo ou coleção de usuários.
Syntax
Get-CMCollectionDirectMembershipRule
-CollectionName <String>
[-ResourceName <String>]
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-CollectionName <String>
-Resource <IResultObject>
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-CollectionName <String>
-ResourceId <String>
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-CollectionId <String>
-Resource <IResultObject>
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-CollectionId <String>
-ResourceId <String>
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-CollectionId <String>
[-ResourceName <String>]
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-InputObject <IResultObject>
-Resource <IResultObject>
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-InputObject <IResultObject>
-ResourceId <String>
[<CommonParameters>]
Get-CMCollectionDirectMembershipRule
-InputObject <IResultObject>
[-ResourceName <String>]
[<CommonParameters>]
Description
Use este cmdlet para obter uma ou mais regras de associação diretas para um dispositivo ou coleção de usuários.
Uma regra de associação direta permite que você escolha explicitamente os membros da coleção de dispositivos.
Coleções padrão não têm regras de associação diretas. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS
.
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: obter todas as regras de associação diretas para uma coleção por nome
Esse comando obtém as regras de associação direta para a coleção chamada Device01.
Get-CMCollectionDirectMembershipRule -CollectionName "Device01"
Exemplo 2: Obter todas as regras de associação direta usando o pipeline
Esse comando usa o cmdlet Get-CMCollection para obter o objeto de coleção chamado User02. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Get-CMCollectionDirectMembershipRule .
Get-CMCollection -Name "User02" | Get-CMCollectionDirectMembershipRule
Parâmetros
-CollectionId
Especifique a ID da coleção para obter a regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012
. Como as coleções padrão não podem ter regras de associação diretas, 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 para obter a regra.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto para a coleção obter a regra. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Resource
Especifique um recurso, dispositivo ou objeto de usuário para obter sua regra de associação direta da coleção. Para obter esse objeto, use os cmdlets Get-CMResource, Get-CMDevice ou Get-CMUser .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
Especifique a ID do recurso para obter sua regra de associação direta da coleção. Esse valor é a propriedade ResourceID , por exemplo 16777219
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceName
Especifique o nome do dispositivo ou do usuário para obter sua regra de associação direta da coleção.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Observações
Esse cmdlet é semelhante a Get-CMDeviceCollectionDirectMembershipRule e Get-CMUserCollectionDirectMembershipRule, que são específicos para o tipo de coleção. Esse cmdlet funciona com conjuntos de dispositivos ou usuários.
Links Relacionados
- Remove-CMCollectionDirectMembershipRule
- Get-CMCollectionExcludeMembershipRule
- Get-CMCollectionIncludeMembershipRule
- Get-CMCollectionQueryMembershipRule
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Get-CMDeviceCollectionDirectMembershipRule
- Get-CMUserCollectionDirectMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Get-CMResource
- Get-CMDevice
- Get-CMUser
- Como criar coleções no Configuration Manager
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