New-CMConfigurationItem

Článek
08/12/2021

SYNOPSIS

Vytvoří položku konfigurace Configuration Manager.

SYNTAX

NewChild (výchozí)

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

Nová

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

DESCRIPTION

Rutina New-CMConfigurationItem vytvoří položku konfigurace v Configuration Manager. Vytvořte položky konfigurace pro definování konfigurací, které chcete spravovat, a vyhodnocení dodržování předpisů na zařízeních.

Pro vytvoření podřízené položky konfigurace můžete zadat parametr ParentConfigurationItem . Podřízené položky konfigurace v Configuration Manager jsou kopie položek konfigurace, které uchovávají vztah k původní položce konfigurace. Proto dědí původní konfiguraci z nadřazené položky konfigurace. Pro mobilní zařízení nemůžete vytvořit podřízené položky konfigurace.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: vytvoření položky konfigurace

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

Tento příkaz vytvoří položku konfigurace pro mobilní zařízení s názvem MD_Config88.

PARAMETERS

– Kategorie

Určuje pole lokalizovaných názvů kategorií, do kterých položka konfigurace patří.

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

– CreationType

Určuje typ položky konfigurace. Tento parametr přijímá tyto hodnoty:

MacOS
MobileDevice
Žádná
Souboru 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

-Description

Určuje popis položky konfigurace.

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

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Určuje název položky konfigurace.

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

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

-ParentConfigurationItem

Určuje nadřazený objekt CMConfigurationItem . K získání objektu CMConfigurationItem použijte rutinu 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.