Dela via


New-CMConfigurationItem

SYNOPSIS

Skapar ett Konfigurationshanteraren konfigurationsobjekt.

SYNTAX

NewChild (standard)

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

Ny

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

DESCRIPTION

Cmdleten New-CMConfigurationItem skapar ett konfigurationsobjekt i Konfigurationshanteraren. Skapa konfigurationsobjekt för att definiera konfigurationer som du vill hantera och utvärdera för kompatibilitet på enheter.

Du kan ange parametern ParentConfigurationItem för att skapa ett underordnat konfigurationsobjekt. Underordnade konfigurationsobjekt i Konfigurationshanteraren kopior av konfigurationsobjekt som behåller en relation till det ursprungliga konfigurationsobjektet. Därför ärver de den ursprungliga konfigurationen från det överordnade konfigurationsobjektet. Du kan inte skapa underordnade konfigurationsobjekt för mobila enheter.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Skapa ett konfigurationsobjekt

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

Det här kommandot skapar ett konfigurationsobjekt för mobila enheter med namnet MD_Config88.

PARAMETERS

-Kategori

Anger en matris med lokaliserade namn på de kategorier som konfigurationsobjektet tillhör.

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

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-CreationType

Anger typen av konfigurationsobjekt. De acceptabla värdena för den här parametern är:

  • MacOS
  • MobileDevice
  • Ingen
  • 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

-Beskrivning

Anger en beskrivning för ett konfigurationsobjekt.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Anger ett namn för konfigurationsobjektet.

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

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

-ParentConfigurationItem

Anger ett överordnat CMConfigurationItem-objekt. Om du vill hämta ett CMConfigurationItem-objekt använder du cmdleten 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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ConfigurationItem

ANTECKNINGAR

Introduktion till efterlevnad Inställningar i Konfigurationshanteraren

Get-CMConfigurationItem

Get-CMConfigurationItemXMLDefinition

Get-CMConfigurationItemHistory

Set-CMConfigurationItem

Remove-CMConfigurationItem

Import-CMConfigurationItem

Export-CMConfigurationItem

ConvertTo-CMConfigurationItem

ConvertFrom-CMConfigurationItem