Condividi tramite

Add-CMUserCollectionIncludeMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

Aggiungere una regola di appartenenza di inclusione a una raccolta di utenti.

Sintassi

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>]

Descrizione

Usare questo cmdlet per aggiungere una regola di appartenenza all'inclusione a una raccolta di utenti. Una regola di appartenenza include i membri di un'altra raccolta alla raccolta utenti in cui viene applicata la regola.

Non è possibile aggiungere regole di appartenenza alle raccolte predefinite. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMScon . È possibile includere una raccolta predefinita, in modo che l'ID di una raccolta inclusa possa iniziare con SMS.

Configuration Manager aggiorna dinamicamente l'appartenenza alla raccolta utenti in base a una pianificazione se cambia l'appartenenza alla raccolta inclusa.

Quando si aggiunge una regola di appartenenza all'inclusione a una raccolta, le risorse possono diventare membri della raccolta. Questa azione può causare l'applicazione di qualsiasi distribuzione di software o configurazione agli utenti nella raccolta inclusa.

Per altre informazioni, vedere Come creare raccolte in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere una regola di appartenenza all'inclusione

Questo comando aggiunge la raccolta di utenti denominata Tutti gli utenti con una regola di appartenenza all'inclusione. La regola viene aggiunta alla raccolta utenti denominata Users.

Add-CMUserCollectionIncludeMembershipRule -CollectionName "Users" -IncludeCollectionName "All Users"

Parametri

-CollectionId

Specificare l'ID della raccolta utenti per aggiungere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. Poiché le raccolte predefinite non includono regole di appartenenza, questo ID inizia con il codice del sito e non SMScon .

Tipo:String
Alias:Id
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare il nome della raccolta utenti per aggiungere la regola.

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeCollection

Specificare un oggetto per l'insieme incluso da aggiungere alla regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMUserCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeCollectionId

Specificare l'ID della raccolta inclusa da aggiungere alla regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. È possibile includere raccolte predefinite, in modo che questo valore possa iniziare con il codice del sito o SMS.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeCollectionName

Specificare il nome della raccolta inclusa da aggiungere alla regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto per la raccolta utenti per aggiungere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMUserCollection .

Tipo:IResultObject
Alias:Collection
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object