Set-CMConfigurationItem
SYNOPSIS
Zmienia ustawienia Menedżer konfiguracji konfiguracji.
SYNTAX
SetByIdMandatory (ustawienie domyślne)
Set-CMConfigurationItem [-AddCategory <String[]>] [-Description <String>] [-Digest <ConfigurationItem>]
[-DigestPath <String>] [-DigestXml <String>] [-Id] <Int32> [-NewName <String>] [-PassThru]
[-RemoveCategory <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SetByNameMandatory
Set-CMConfigurationItem [-AddCategory <String[]>] [-Description <String>] [-Digest <ConfigurationItem>]
[-DigestPath <String>] [-DigestXml <String>] [-Name] <String> [-NewName <String>] [-PassThru]
[-RemoveCategory <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SetByValueMandatory
Set-CMConfigurationItem [-AddCategory <String[]>] [-Description <String>] [-Digest <ConfigurationItem>]
[-DigestPath <String>] [-DigestXml <String>] [-InputObject] <IResultObject> [-NewName <String>] [-PassThru]
[-RemoveCategory <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Polecenie cmdlet Set-CMConfigurationItem zmienia ustawienia Menedżer konfiguracji konfiguracji.
Elementy konfiguracji zawierają co najmniej jedno ustawienia wraz z regułami zgodności. Elementy zwykle definiują jednostkę konfiguracji, którą chcesz monitorować. Aby uzyskać więcej informacji na temat elementów konfiguracji, zobacz Introduction to Compliance Ustawienia in Menedżer konfiguracji.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: zmiana nazwy elementu konfiguracji
PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"
To polecenie zmienia nazwę elementu konfiguracji o nazwie CITest na CITest01.
Przykład 2: ustawianie ustawień elementu
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"
To polecenie ustawia akcję zakresu zabezpieczeń na AddMembership, a nazwa zakresu zabezpieczeń na DefaultScope dla elementu o nazwie CITest01.
Przykład 3: Zmienianie ustawień elementu
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"
To polecenie ustawia akcję zakresu zabezpieczeń na RemoveMembership, a nazwa zakresu zabezpieczeń na DefaultScope dla elementu o nazwie CITest01.
PARAMETERS
-AddCategory
Określa tablicę zlokalizowanych nazw kategorii, do których należy element konfiguracji.
Type: String[]
Parameter Sets: (All)
Aliases:
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
-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
-Digest
Określa skrót, który zawiera element konfiguracji.
Type: ConfigurationItem
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DigestPath
Określa ścieżkę skrótu.
Type: String
Parameter Sets: (All)
Aliases: DesiredConfigurationDigestPath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DigestXml
Określa definicję XML.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. 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
-Id (Identyfikator)
Określa tablicę identyfikatorów dla jednego lub większej liczby elementów konfiguracji. Można użyć listy rozdzielonych przecinkami.
Type: Int32
Parameter Sets: SetByIdMandatory
Aliases: CIId, CI_ID
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określa obiekt elementu konfiguracji. Aby uzyskać obiekt elementu konfiguracji, można użyć polecenia cmdlet Get-CMConfigurationItem.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Określa tablicę nazw elementów konfiguracji.
Type: String
Parameter Sets: SetByNameMandatory
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Określa nową nazwę elementu konfiguracji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Zwraca bieżący obiekt roboczy. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveCategory
Określa tablicę zlokalizowanych nazw kategorii, z których ma być usuwany element konfiguracji.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
UWAGI
RELATED LINKS
Wprowadzenie do zasad zgodności Ustawienia w Menedżer konfiguracji
Get-CMConfigurationItemXMLDefinition