Dela via


Set-CMSoftwareMeteringRule

SYNOPSIS

Ändrar egenskaper och säkerhetsomfattningar för Konfigurationshanteraren regler för avläsning av programvara.

SYNTAX

SetByValueMandatory (standard)

Set-CMSoftwareMeteringRule [-Comment <String>] [-FileName <String>] [-FileVersion <String>]
 -InputObject <IResultObject> [-LanguageId <Int32>] [-NewProductName <String>] [-OriginalFileName <String>]
 [-PassThru] [-Path <String>] [-SiteCode <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMSoftwareMeteringRule [-Comment <String>] [-FileName <String>] [-FileVersion <String>]
 [-LanguageId <Int32>] [-NewProductName <String>] [-OriginalFileName <String>] [-PassThru] [-Path <String>]
 -ProductName <String> [-SiteCode <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SetById

Set-CMSoftwareMeteringRule [-Comment <String>] [-FileName <String>] [-FileVersion <String>] -Id <String>
 [-LanguageId <Int32>] [-NewProductName <String>] [-OriginalFileName <String>] [-PassThru] [-Path <String>]
 [-SiteCode <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Cmdleten Set-CMSoftwareMeteringRule ändrar egenskaper för regler för avläsning av programvara i Konfigurationshanteraren och lägger till eller tar bort säkerhetsomfattningar för regler för avläsning av programvara. Varje regel måste ha minst en säkerhetsomfattning.

Avläsning av programvara övervakar och samlar in användningsdata från Konfigurationshanteraren klienter, till exempel när klienter började använda ett visst program och hur länge användarna har arbetat med programvaran. Du kan skapa regler för avläsning av programvara som anger vilken programvara som ska övervakas.

Om du vill ändra regelegenskaper kan du ange regler som ska ändras efter ID eller produktnamn, eller använda cmdleten Get-CMSoftwareMeteringRule. På samma sätt kan du ändra säkerhetsomfattningen för regler för angivet ID, produktnamn eller med hjälp av Get-CMSoftwareMeteringRule.

Mer information om avläsning av programvara i Konfigurationshanteraren finns i Introduktion till avläsning av programvara i Konfigurationshanteraren. Mer information om säkerhetsomfattningar finns i Planera för säkerhet i Konfigurationshanteraren.

Anteckning

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

EXAMPLES

Exempel 1: Ändra nationella regler för en produkt

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -LanguageID 1036

Det här kommandot anger språk-ID för regler som innehåller produktnamnet Accounting Package.

Exempel 2: Lägga till en säkerhetsomfattning i regler för en produkt

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -SecurityScopeAction AddMembership -SecurityScopeName "Scope05"

Det här kommandot lägger till säkerhetsomfattningen Scope05 till regler för produktnamnet Accounting Package.

PARAMETERS

-Kommentar

Anger en kommentar för en regel för avläsning av programvara.

Type: String
Parameter Sets: (All)
Aliases:

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

-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

-FileName

Anger filnamnet för den programvara som en regel mäter.

Type: String
Parameter Sets: (All)
Aliases:

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

-FileVersion

Anger en version av programvaran som en regel mäter.

Type: String
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

-Id

Anger en matris med-ID:er för regler för avläsning av programvara.

Type: String
Parameter Sets: SetById
Aliases: RuleId

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

-InputObject

Anger ett regelobjekt för avläsning av programvara. Om du vill hämta ett regelobjekt för avläsning av programvara använder du cmdleten Get-CMSoftwareMeteringRule.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

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

-LanguageId

Anger ett språk för programvaran som en regel mäter. Mer information och en lista över språkidentifierare finns i Bilaga A: Produktbeteende.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-NewProductName

Anger ett nytt namn för programvaran som en regel mäter.

Type: String
Parameter Sets: (All)
Aliases:

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

-OriginalFileName

Anger ett ursprungligt filnamn för programvaran som en regel mäter. Den här parametern kan skilja sig från parametern FileName om en användare har ändrat namnet.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Anger en filsökväg för programvaran som en regel mäter.

Type: String
Parameter Sets: (All)
Aliases:

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

-ProductName

Anger ett namn för en produkt som en regel mäter.

Type: String
Parameter Sets: SetByName
Aliases:

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

-SiteCode

Anger en platskod för en Konfigurationshanteraren plats.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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

System.Object

ANTECKNINGAR

Disable-CMSoftwareMeteringRule

Enable-CMSoftwareMeteringRule

Get-CMSoftwareMeteringRule

New-CMSoftwareMeteringRule

Remove-CMSoftwareMeteringRule