New-CMConfigurationItem

Artykuł
08/17/2021

SYNOPSIS

Tworzy Menedżer konfiguracji konfiguracji.

SYNTAX

NewChild (ustawienie domyślne)

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

Nowy

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

DESCRIPTION

Polecenie cmdlet New-CMConfigurationItem tworzy element konfiguracji w Menedżer konfiguracji. Utwórz elementy konfiguracji w celu zdefiniowania konfiguracji, które chcesz zarządzać i oceniać pod uwagę zgodność na urządzeniach.

Możesz określić parametr ParentConfigurationItem, aby utworzyć podrzędny element konfiguracji. Podrzędne elementy konfiguracji w Menedżer konfiguracji to kopie elementów konfiguracji, które zachowują relację z oryginalnym elementem konfiguracji; w związku z tym dziedziczą oryginalną konfigurację z nadrzędnego elementu konfiguracji. Nie można tworzyć elementów konfiguracji podrzędnej dla urządzeń przenośnych.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Tworzenie elementu konfiguracji

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

To polecenie tworzy element konfiguracji dla urządzeń przenośnych o nazwie MD_Config88.

PARAMETERS

-Category (Kategoria)

Określa tablicę zlokalizowanych nazw kategorii, do których należy element konfiguracji.

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

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-CreationType

Określa typ elementu konfiguracji. Dopuszczalne wartości dla tego parametru to:

MacOS
MobileDevice
Brak
Aplikacja systemu Windows
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 (Opis)

Określa opis elementu konfiguracji.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Określa nazwę elementu konfiguracji.

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

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

-ParentConfigurationItem

Określa obiekt nadrzędny CMConfigurationItem. Aby uzyskać obiekt CMConfigurationItem, użyj polecenia 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

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.