vSphere PowerCLI Reference

Set-VMHostSysLogServer

Synopsis

Configures the remote syslog server of the specified hosts.

Syntax

Set-VMHostSysLogServer [[-SysLogServer] <NamedIPEndPoint>] [-VMHost] <VMHost[]> [-SysLogServerPort <Int32>] [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-VMHostSysLogServer

Detailed Description

Configures the remote syslog server of the specified hosts.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
SysLogServerNamedIPEndPointSpecify the sys log servers you want to configure. The parameter takes objects of the NamedIPEndPoint, IPEndPoint, IPAddress, and String types.
The accepted formats, if string is used, are DNS names and the standard IPv6/IPv4 format: FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:192.168.0.1:80, where the FFFF:FFFF:FFFF:FFFF:FFFF:FFFF can be replaced by any hex value with the same structure (both upper or lower case). It is only meaningful in case of IPv6 address and is omitted for IPv4. The 192.168.0.1 part is mandatory and can be any address in the IPv4 format. The :80 part is optional. If omitted, the port must be specified through the SysLogServerPort parameter. If Syslog is set to null, then the configured syslog server, if any, is removed.
falsetrue (ByValue)
VMHostVMHost[]Specify the host whose syslog servers you want to configure.truetrue (ByValue)
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse$true
ServerVIServer[]Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falsefalse
SysLogServerPortInt32Specify the sys log server port. Must be specified if the string that is passed to the SysLogServer parameter does not contain the port value, or the argument of the SysLogServer is an IP address.falsefalse
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

NamedIPEndPoint

Notes

Examples

-------------- Example 1 --------------

Set-VMHostSysLogServer -SysLogServer '192.168.0.1:133' -VMHost Host

Sets a SysLog server on the Host virtual machine host.

-------------- Example 2 --------------

Set-VMHostSysLogServer -SysLogServer $null -VMHost Host

Removes the SysLog server from the Host virtual machine host.


Copyright © 1998 - 2012 VMware, Inc. All rights reserved.