Delen via


New-CMConfigurationItem

SYNOPSIS

Hiermee maakt u Configuration Manager configuratie-item.

SYNTAX

NewChild (standaard)

New-CMConfigurationItem [-Category <String[]>] [-Description <String>] -Name <String>
 -ParentConfigurationItem <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

Nieuw

New-CMConfigurationItem [-Category <String[]>] -CreationType <CICreationType> [-Description <String>]
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet New-CMConfigurationItem maakt een configuratie-item in Configuration Manager. Maak configuratie-items om configuraties te definiëren die u wilt beheren en beoordelen op naleving op apparaten.

U kunt de parameter ParentConfigurationItem opgeven om een onderliggend configuratie-item te maken. Onderliggende configuratie-items in Configuration Manager zijn kopieën van configuratie-items die een relatie met het oorspronkelijke configuratie-item behouden; Daarom nemen ze de oorspronkelijke configuratie over van het bovenliggende configuratie-item. U kunt geen onderliggende configuratie-items maken voor mobiele apparaten.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een configuratie-item maken

PS XYZ:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"

Met deze opdracht maakt u een configuratie-item voor mobiele apparaten met de MD_Config88.

PARAMETERS

-Categorie

Hiermee geeft u een matrix met gelokaliseerde namen van de categorieën waar het configuratie-item bij hoort.

Type: String[]
Parameter Sets: (All)
Aliases: LocalizedCategoryInstanceNames

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-CreationType

Hiermee geeft u het type configuratie-item. De aanvaardbare waarden voor deze parameter zijn:

  • MacOS
  • MobileDevice
  • Geen
  • WindowsApplication
  • WindowsOS
Type: CICreationType
Parameter Sets: New
Aliases:
Accepted values: None, WindowsApplication, WindowsOS, MacOS, MobileDevice

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Beschrijving

Hiermee geeft u een beschrijving voor een configuratie-item.

Type: String
Parameter Sets: (All)
Aliases: LocalizedDescription

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Hiermee geeft u een naam op voor het configuratie-item.

Type: String
Parameter Sets: (All)
Aliases: LocalizedDisplayName

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ParentConfigurationItem

Hiermee geeft u een bovenliggend CMConfigurationItem-object op. Als u een CMConfigurationItem-object wilt verkrijgen, gebruikt u de cmdlet Get-CMConfigurationItem.

Type: IResultObject
Parameter Sets: NewChild
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ConfigurationItem

OPMERKINGEN

Inleiding tot naleving Instellingen in Configuration Manager

Get-CMConfigurationItem

Get-CMConfigurationItemXMLDefinition

Get-CMConfigurationItemHistory

Set-CMConfigurationItem

Remove-CMConfigurationItem

Import-CMConfigurationItem

Export-CMConfigurationItem

ConvertTo-CMConfigurationItem

ConvertFrom-CMConfigurationItem