Set-SilLogging

Applies configuration settings for Software Inventory Logging.

Syntax

Set-SilLogging
   [-TimeOfDay <DateTime>]
   [-TargetUri <String>]
   [-CertificateThumbprint <String>]
   [-CimSession <CimSession[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SilLogging
   -TimeOfDay <DateTime>
   [-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.

Required Parameters

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

Optional 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
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[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
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
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
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.Management.Infrastructure.CimMethodResult#msftsil_managementtasks#SetLoggingState