Set-RASAgentLogLevel

NAME

Set-RASAgentLogLevel

SYNOPSIS

Updates the Log Level of one or more RAS Agents.

SYNTAX

Set-RASAgentLogLevel [-InputObject] (RASAgentInfo[]) -LogLevel {Standard | Extended | Verbose | None} [-DurationInSec (uint)] [(CommonParameters)] **

Set-RASAgentLogLevel [[-Server] (string)] [[-SiteId] (uint)] -LogLevel {Standard | Extended | Verbose | None} [DurationInSec (uint)] [ServerType {RDS | Provider | Gateway | Broker | HALBDevice | EnrollmentServer | All}] [(CommonParameters)] **

DESCRIPTION

Updates the Log Level of one or more RAS Agents.

PARAMETERS

LogLevel (RASLogLevel)

The new Log Level value.

Possible values: Standard, Extended, Verbose, None

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

DurationInSec (uint)

The duration before the log level is reset back to Standard level (in seconds).

Only applies for 'Extended' and 'Verbose' levels.

Extended: (Default: 43200 (12 hours), Min: 3600 (1 hour), Max: 259200 (72 hours), Never: 0).

Verbose: (Default: 43200 (12 hours), Min: 3600 (1 hour), Max: 259200 (72 hours)).

        Required?                    false

        Position?                    named

        Default value                43200

        Accept pipeline input?       false

        Accept wildcard characters?  false

ServerType (RASLogSrvType)

Specifies the server type for which to retrieve the information.

Possible values: RDS, Provider, Gateway, Broker, HALBDevice, EnrollmentServer, All

        Required?                    false

        Position?                    named

        Default value                All

        Accept pipeline input?       false

        Accept wildcard characters?  false

Server (string)

The name of the RAS agent server.

The name can be either FQDN or IP address, but you have to enter the actual name this server has in the RAS farm.

        Required?                    false

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

SiteId (uint)

Site ID in which to modify the specified server.

If the parameter is omitted, the site ID of the Licensing Server will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

InputObject (RASAgentInfo[])

The RAS agent info.

To obtain an RASAgentInfo object representing an RAS agent info list, use the Get-RASAgent command."

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

(CommonParameters)

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

RASAgentInfo[]

OUTPUTS

-none-

---------- EXAMPLE 1 ----------

Set-RASAgentLogLevel -ServerType RDS -LogLevel Extended

Modifies the log level for every RAS RDS Agent to 'Extended'.

NB. If -Duration is ommitted, a 12 hours duration is set by default.

After duration has passed, the LogLevel is automatically reset to Standard. ---------- EXAMPLE 2 ----------

Set-RASAgentLogLevel -Server MyRASserver -LogLevel Verbose -DurationInSec 43200

Modifies the log level for the specified RAS server to 'Verbose' for a duration of 12 hours. ---------- EXAMPLE 3 ----------

Set-RASAgentLogLevel -InputObject $RDSStatus -LogLevel Extended -DurationInSec 259200

Modifies the log level for the specified RDS RAS server to 'Extended' for maximum duration (72 hours).

RELATED LINKS

• Invoke-RASRetrieveAgentLogs

• Invoke-RASClearAgentLogs