Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Set-SilLogging

Brian Lich|Last Updated: 4/3/2017

SYNOPSIS

Applies configuration settings for Software Inventory Logging.

SYNTAX

TimeOfDay (Default)

Set-SilLogging -TimeOfDay <DateTime> [-CimSession <CimSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

TargetUri

Set-SilLogging [-TimeOfDay <DateTime>] [-TargetUri <String>] [-CertificateThumbprint <String>]
 [-CimSession <CimSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-SilLogging cmdlet applies configuration settings for Software Inventory Logging. If logging is started, Software Inventory Logging collects data daily from all Software Inventory Logging data sources, and then forwards this data over the network to an aggregation server. Specify an aggregation server by using this cmdlet. If you do not specify an aggregation server and the server is a virtual machine that runs on a Hyper-V host, then the daily collection forwards the Software Inventory Logging data to a location that its Windows Server host can access. This cmdlet sets the time of day that the daily collection occurs, the uniform resource identifier (URI) of the aggregation server, and the certificate thumbprint to use for encryption.

Use the Start-SilLogging cmdlet to start logging.

EXAMPLES

Example 1: Specify an aggregation server

PS C:\> Set-SilLogging -TargetUri "https://log03.hosts.contoso.com"

This command specifies an aggregation server for Software Inventory Logging for the current computer.

Example 2: Specify a time of day

PS C:\> Set-SilLogging -TimeOfDay "01/01/2013 5:00:00AM"

This command specifies the time of day that the computer forwards logging data. Note that when you specify a date in the future, Software Inventory Logging does not start logging until that date and time. If you specify a date in the past, only the time specified is relevant to the configuration setting.

PARAMETERS

-CertificateThumbprint

Specifies a certificate thumbprint as a string. Software Inventory Logging encrypts logging data sent to the aggregation server by using this thumbprint. If you do not specify a value for this parameter, Software Inventory Logging does not encrypt data.

Type: String
Parameter Sets: TargetUri
Aliases: 

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

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type: CimSession[]
Parameter Sets: (All)
Aliases: 

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

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

-TargetUri

Specifies the URI of an aggregation server. If you do not specify a value for this parameter, Software Inventory Logging does not send logging data over the network.

If you do not specify an aggregation server for a virtual machine that runs on a computer that runs Hyper-V, Software Inventory Logging forwards logging data to a location that its Windows Server host can access.

Type: String
Parameter Sets: TargetUri
Aliases: 

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

-TimeOfDay

Specifies the time of day as a DateTime object when Software Inventory Logging forwards data. To obtain a DateTime object, use the Get-Date cmdlet. For more information, type Get-Help Get-Date. The default value is 3 a.m.

Type: DateTime
Parameter Sets: TimeOfDay
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: DateTime
Parameter Sets: TargetUri
Aliases: 

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

Microsoft.Management.Infrastructure.CimMethodResult#msftsil_managementtasks#SetLoggingState

NOTES

Get-SilLogging

Start-SilLogging

Stop-SilLogging

Publish-SilData

© 2017 Microsoft