< Back
Set-VDSecurityPolicy
Post
NAME Set-VDSecurityPolicy
SYNOPSIS
This cmdlet modifies the security policy for distributed ports.
SYNTAX
Set-VDSecurityPolicy [-Policy] <SecurityPolicy[]> [-AllowPromiscuous <Boolean>] [-AllowPromiscuousInherited
<Boolean>] [-ForgedTransmits <Boolean>] [-ForgedTransmitsInherited <Boolean>] [-MacChanges <Boolean>]
[-MacChangesInherited <Boolean>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
This cmdlet modifies the security policy for distributed ports or the default port policy at port group or switch
level (depending on the input policy).
PARAMETERS
-AllowPromiscuous <Boolean>
Specifies whether promiscuous mode is enabled for the corresponding distributed port, port group, or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowPromiscuousInherited <Boolean>
Specifies whether the AllowPromiscuous setting is inherited from a parent object, such as a distributed port
group or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ForgedTransmits <Boolean>
Specifies whether forged transmits are enabled for the corresponding distributed port, port group, or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ForgedTransmitsInherited <Boolean>
Specifies whether the ForgedTransmits setting is inherited from a parent object, such as a distributed port
group or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MacChanges <Boolean>
Specifies whether MAC address changes are enabled for the corresponding distributed port, port group, or
switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MacChangesInherited <Boolean>
Specifies whether the MacChanges setting is inherited from a parent object, such as a distributed port group
or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Policy <SecurityPolicy[]>
Specifies the security policy that you want to configure.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
If 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.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are
modified.
Required? false
Position? named
Default value False
Accept pipeline input? False
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 (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
The modified SecurityPolicy objects
NOTES
-------------------------- Example 1 --------------------------
Get-VDSwitch "MyVDSwitch" | Get-VDSecurityPolicy | Set-VDSecurityPolicy -MacChanges $true
Retrieves a vSphere distributed switch named "MyVDSwitch" and updates its security policy to allow MAC address
changes.
-------------------------- Example 2 --------------------------
Get-VDPortgroup "MyVDPortgroup" | Get-VDSecurityPolicy | Set-VDSecurityPolicy -ForgedTransmitsInherited $true
Retrieves a distributed port group named "MyVDPortgroup" and updates the security policy to inherit the setting
value for controlling outbound frames filtering by MAC address from its parent.
RELATED LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... olicy.html
Get-VDSecurityPolicy
SYNOPSIS
This cmdlet modifies the security policy for distributed ports.
SYNTAX
Set-VDSecurityPolicy [-Policy] <SecurityPolicy[]> [-AllowPromiscuous <Boolean>] [-AllowPromiscuousInherited
<Boolean>] [-ForgedTransmits <Boolean>] [-ForgedTransmitsInherited <Boolean>] [-MacChanges <Boolean>]
[-MacChangesInherited <Boolean>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
This cmdlet modifies the security policy for distributed ports or the default port policy at port group or switch
level (depending on the input policy).
PARAMETERS
-AllowPromiscuous <Boolean>
Specifies whether promiscuous mode is enabled for the corresponding distributed port, port group, or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowPromiscuousInherited <Boolean>
Specifies whether the AllowPromiscuous setting is inherited from a parent object, such as a distributed port
group or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ForgedTransmits <Boolean>
Specifies whether forged transmits are enabled for the corresponding distributed port, port group, or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ForgedTransmitsInherited <Boolean>
Specifies whether the ForgedTransmits setting is inherited from a parent object, such as a distributed port
group or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MacChanges <Boolean>
Specifies whether MAC address changes are enabled for the corresponding distributed port, port group, or
switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MacChangesInherited <Boolean>
Specifies whether the MacChanges setting is inherited from a parent object, such as a distributed port group
or switch.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Policy <SecurityPolicy[]>
Specifies the security policy that you want to configure.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
If 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.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are
modified.
Required? false
Position? named
Default value False
Accept pipeline input? False
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 (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
The modified SecurityPolicy objects
NOTES
-------------------------- Example 1 --------------------------
Get-VDSwitch "MyVDSwitch" | Get-VDSecurityPolicy | Set-VDSecurityPolicy -MacChanges $true
Retrieves a vSphere distributed switch named "MyVDSwitch" and updates its security policy to allow MAC address
changes.
-------------------------- Example 2 --------------------------
Get-VDPortgroup "MyVDPortgroup" | Get-VDSecurityPolicy | Set-VDSecurityPolicy -ForgedTransmitsInherited $true
Retrieves a distributed port group named "MyVDPortgroup" and updates the security policy to inherit the setting
value for controlling outbound frames filtering by MAC address from its parent.
RELATED LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... olicy.html
Get-VDSecurityPolicy