Add-CMDeviceCollectionIncludeMembershipRule
Aggiungi una regola di appartenenza di inclusione a una raccolta di dispositivi.
Sintassi
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Utilizzare questo cmdlet per aggiungere una regola di inclusione di appartenenza a una raccolta di dispositivi. Una regola di appartenenza include i membri di un'altra raccolta alla raccolta di dispositivi 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 SMS
. È possibile includere un insieme predefinito, in modo che l'ID di un insieme incluso possa iniziare con SMS
.
Configuration Manager aggiorna dinamicamente l'appartenenza della raccolta di dispositivi in base a una pianificazione se l'appartenenza della raccolta inclusa cambia.
Quando si aggiunge una regola di inclusione di appartenenza a una raccolta, le risorse possono diventare membri della raccolta. Questa azione può causare l'applicazione di qualsiasi distribuzione di software o configurazione ai dispositivi nella raccolta inclusa.
Per ulteriori 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 ulteriori informazioni, vedere Introduzione.
Esempio
Esempio 1: Aggiungere una regola di appartenenza di inclusione
Questo comando aggiunge la raccolta di dispositivi denominata All Systems con una regola di appartenenza include. La regola viene aggiunta alla raccolta di dispositivi denominata Device.
Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"
Esempio 2: Aggiungere una regola di appartenenza di inclusione a una raccolta tramite la pipeline
Questo comando utilizza innanzitutto il cmdlet Get-CMCollection per ottenere l'oggetto insieme di destinazione denominato Device. Viene quindi utilizzato l'operatore della pipeline per passare l'oggetto al cmdlet Add-CMDeviceCollectionIncludeMembershipRule, che aggiunge una regola di appartenenza include per la raccolta di dispositivi denominata All Systems.
Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"
Parametri
-CollectionId
Specifica l'ID della raccolta di dispositivi 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 SMS
con .
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specifica il nome della raccolta di dispositivi per aggiungere la regola.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollection
Specificare un oggetto per l'insieme incluso da aggiungere alla regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMDeviceCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionName
Specificare il nome della raccolta inclusa da aggiungere alla regola.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specificare un oggetto per l'insieme di dispositivi per aggiungere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMDeviceCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object