en-US/DisplayConfig.dll-Help.xml
|
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Copy-DisplaySource</command:name> <command:verb>Copy</command:verb> <command:noun>DisplaySource</command:noun> <maml:description> <maml:para>Clones 1 source display to 1 or more destination displays.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Clones 1 source display to 1 or more destination displays. To stop cloning you can either change the display profile to anything other than `Clone`, or use `Enable-Display`</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Copy-DisplaySource</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="SourceDisplayId"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The source display to clone output from. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>DestinationDisplayId</maml:name> <maml:description> <maml:para>The target display(s) to clone the source to. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Copy-DisplaySource</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="SourceDisplayId"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The source display to clone output from. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>DestinationDisplayId</maml:name> <maml:description> <maml:para>The target display(s) to clone the source to. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>DestinationDisplayId</maml:name> <maml:description> <maml:para>The target display(s) to clone the source to. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="SourceDisplayId"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The source display to clone output from. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Copy-DisplaySource -DisplayId 2 -DestinationDisplayId 1,3</dev:code> <dev:remarks> <maml:para>Clones the second display to displays 1 and 3.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Disable-Display</command:name> <command:verb>Disable</command:verb> <command:noun>Display</command:noun> <maml:description> <maml:para>Removes a display from the active desktop.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Removes a display from the active desktop.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Disable-Display</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) that should be disabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Disable-Display</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) that should be disabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) that should be disabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Disable-Display -DisplayId 3</dev:code> <dev:remarks> <maml:para>Disables the third display.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Disable-DisplayAdvancedColor</command:name> <command:verb>Disable</command:verb> <command:noun>DisplayAdvancedColor</command:noun> <maml:description> <maml:para>Disables Advanced color AKA HDR on the specified display. This is the same as toggling the "Use HDR" switch in the display settings.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Disables Advanced color AKA HDR on the specified display. This is the same as toggling the "Use HDR" switch in the display settings.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Disable-DisplayAdvancedColor</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where HDR should be disabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where HDR should be disabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Disable-DisplayAdvancedColor -DisplayId 3</dev:code> <dev:remarks> <maml:para>Disables HDR on the third display.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Enable-Display</command:name> <command:verb>Enable</command:verb> <command:noun>Display</command:noun> <maml:description> <maml:para>Reenables a display, this is the same as picking "Extend desktop to this display" in the settings app. If the display is already active, but is used for display cloning then this will stop the cloning.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Reenables a display, this is the same as picking "Extend desktop to this display" in the settings app. If the display is already active, but is used for display cloning then this will stop the cloning.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Enable-Display</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display to enable. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display to enable. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Enable-Display -DisplayId 3</dev:code> <dev:remarks> <maml:para>Reenables the third display, adding it back to the desktop if it was previously turned off or used for cloning.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Enable-DisplayAdvancedColor</command:name> <command:verb>Enable</command:verb> <command:noun>DisplayAdvancedColor</command:noun> <maml:description> <maml:para>Enables Advanced color AKA HDR on the specified display. This is the same as toggling the "Use HDR" switch in the display settings.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Enables Advanced color AKA HDR on the specified display. This is the same as toggling the "Use HDR" switch in the display settings.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Enable-DisplayAdvancedColor</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display where HDR should be enabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display where HDR should be enabled. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Enable-DisplayAdvancedColor -DisplayId 3</dev:code> <dev:remarks> <maml:para>Enables HDR on display 3.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-DisplayColorInfo</command:name> <command:verb>Get</command:verb> <command:noun>DisplayColorInfo</command:noun> <maml:description> <maml:para>Gets various color and HDR details about a display.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets various color and HDR details about a display.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-DisplayColorInfo</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display to get color data for. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display to get color data for. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.ColorInfo</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayColorInfo -DisplayId 3</dev:code> <dev:remarks> <maml:para>Gets color and HDR info for the third display.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-DisplayConfig</command:name> <command:verb>Get</command:verb> <command:noun>DisplayConfig</command:noun> <maml:description> <maml:para>Gets the current display topology settings, which can then be exported or modified and later applied.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets the current display topology settings, which can then be exported or modified and later applied. This can be combined with Export/Import-Clixml to save various topology profiles that can later be applied. Some commands in this module also supports modifying the topology settings so multiple settings can be applied at once, minimizing the amount of flickering that occurs whenever a setting is changed. The compatible commands can be found like this: `Get-Command -Module DisplayConfig -ParameterName DisplayConfig` Advanced users can also manually modify the path/mode settings before applying them.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-DisplayConfig</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Flags</maml:name> <maml:description> <maml:para>Only for advanced users! By default, all paths are enumerated which can be a bit slow. To make things faster you can request info for only the active paths, or the current CCD database. Beware that if a display is disabled it may affect the displayIds assigned to each display, since the code no longer knows about all connected displays. More information can be found at: https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-querydisplayconfig#parameters</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">QDC_ALL_PATHS</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">QDC_ONLY_ACTIVE_PATHS</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">QDC_DATABASE_CURRENT</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">QDC_VIRTUAL_MODE_AWARE</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">QDC_INCLUDE_HMD</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">QDC_VIRTUAL_REFRESH_RATE_AWARE</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">DisplayConfigFlags</command:parameterValue> <dev:type> <maml:name>DisplayConfigFlags</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Flags</maml:name> <maml:description> <maml:para>Only for advanced users! By default, all paths are enumerated which can be a bit slow. To make things faster you can request info for only the active paths, or the current CCD database. Beware that if a display is disabled it may affect the displayIds assigned to each display, since the code no longer knows about all connected displays. More information can be found at: https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-querydisplayconfig#parameters</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfigFlags</command:parameterValue> <dev:type> <maml:name>DisplayConfigFlags</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayConfig | Export-Clixml -Path $HOME\TvProfile.xml</dev:code> <dev:remarks> <maml:para>Exports the current settings so they can later be used like this: `Import-Clixml $HOME\TvProfile.xml | Use-DisplayConfig -UpdateAdapterIds`</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 2 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayConfig | Disable-Display -DisplayId 3 | Set-DisplayRotation -DisplayId 1 -Rotation Rotate90 | Set-DisplayPrimary -DisplayId 2 | Use-DisplayConfig</dev:code> <dev:remarks> <maml:para>Changes various settings in the config, before applying them all at once. This reduces the flickering and the time it takes to change multiple settings.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-DisplayInfo</command:name> <command:verb>Get</command:verb> <command:noun>DisplayInfo</command:noun> <maml:description> <maml:para>Gets various details about the connected displays. Information includes: Display ID, display model name, connection type, and more.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets various details about the connected displays. Information includes: Display ID, display model name, connection type, and more.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-DisplayInfo</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>Specifies the display(s) to get information about.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>Specifies the display(s) to get information about.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayInfo</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayInfo</dev:code> <dev:remarks> <maml:para>Gets basic display info about all connected displays.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-DisplayProfile</command:name> <command:verb>Get</command:verb> <command:noun>DisplayProfile</command:noun> <maml:description> <maml:para>Gets the current display profile (Windows key + P).</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets the current display profile (Windows key + P).</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-DisplayProfile</maml:name> </command:syntaxItem> </command:syntax> <command:parameters /> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.TopologyProfile</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayProfile</dev:code> <dev:remarks> <maml:para>Gets the current display profile.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-DisplayScale</command:name> <command:verb>Get</command:verb> <command:noun>DisplayScale</command:noun> <maml:description> <maml:para>Gets information about the current, recommended and max DPI for the specified displays.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets information about the current, recommended and max DPI for the specified displays.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-DisplayScale</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>Specifies the displays to get the scaling information from.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>Specifies the displays to get the scaling information from.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DpiScale</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayScale 1,2</dev:code> <dev:remarks> <maml:para>Retrieves the DPI scaling information for displays 1 and 2.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayPosition</command:name> <command:verb>Set</command:verb> <command:noun>DisplayPosition</command:noun> <maml:description> <maml:para>Changes the position of one or more displays.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Changes the position of one or more displays. This does not move displays that are already in the specified position so it may be necessary to combine this command with `Get-DisplayConfig` and run this multiple times to move the displays one by one.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be moved. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to readjust positions to make the config work, in case of overlapping displays.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ApplyNow</maml:name> <maml:description> <maml:para>Helps PowerShell resolve the correct parameter set to apply the configuration changes immediately. The actual value is not used.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AsOffset</maml:name> <maml:description> <maml:para>Treat the specified positions as an offset of the current position.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>XPosition</maml:name> <maml:description> <maml:para>Specifies either the literal (default) or relative (when used with `-AsOffset`) X (horizontal) position where the display should be moved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>YPosition</maml:name> <maml:description> <maml:para>Specifies either the literal (default) or relative (when used with `-AsOffset`) Y (vertical) position where the display should be moved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be moved. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to readjust positions to make the config work, in case of overlapping displays.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ApplyNow</maml:name> <maml:description> <maml:para>Helps PowerShell resolve the correct parameter set to apply the configuration changes immediately. The actual value is not used.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Position</maml:name> <maml:description> <maml:para>The position where the specified display should be placed, relative to the display specified with `-RelativeDisplayId`.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">Left</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Right</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Above</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Under</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">RelativePosition</command:parameterValue> <dev:type> <maml:name>RelativePosition</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>RelativeDisplayId</maml:name> <maml:description> <maml:para>Specifies the display that the `-Position` parameter refers to.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to readjust positions to make the config work, in case of overlapping displays.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ApplyNow</maml:name> <maml:description> <maml:para>Helps PowerShell resolve the correct parameter set to apply the configuration changes immediately. The actual value is not used.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>LeftToRightDisplayIds</maml:name> <maml:description> <maml:para>Places the specified displays side by side, placing the first display as far left as possible, the second display right next to it, and so on. Every active display needs to be specified.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to readjust positions to make the config work, in case of overlapping displays.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ApplyNow</maml:name> <maml:description> <maml:para>Helps PowerShell resolve the correct parameter set to apply the configuration changes immediately. The actual value is not used.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>SwapDisplay</maml:name> <maml:description> <maml:para>The displayIDs of the 2 displays whose position should be swapped. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be moved. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AsOffset</maml:name> <maml:description> <maml:para>Treat the specified positions as an offset of the current position.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>XPosition</maml:name> <maml:description> <maml:para>Specifies either the literal (default) or relative (when used with `-AsOffset`) X (horizontal) position where the display should be moved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>YPosition</maml:name> <maml:description> <maml:para>Specifies either the literal (default) or relative (when used with `-AsOffset`) Y (vertical) position where the display should be moved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be moved. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Position</maml:name> <maml:description> <maml:para>The position where the specified display should be placed, relative to the display specified with `-RelativeDisplayId`.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">Left</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Right</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Above</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Under</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">RelativePosition</command:parameterValue> <dev:type> <maml:name>RelativePosition</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>RelativeDisplayId</maml:name> <maml:description> <maml:para>Specifies the display that the `-Position` parameter refers to.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>LeftToRightDisplayIds</maml:name> <maml:description> <maml:para>Places the specified displays side by side, placing the first display as far left as possible, the second display right next to it, and so on. Every active display needs to be specified.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPosition</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>SwapDisplay</maml:name> <maml:description> <maml:para>The displayIDs of the 2 displays whose position should be swapped. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to readjust positions to make the config work, in case of overlapping displays.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ApplyNow</maml:name> <maml:description> <maml:para>Helps PowerShell resolve the correct parameter set to apply the configuration changes immediately. The actual value is not used.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AsOffset</maml:name> <maml:description> <maml:para>Treat the specified positions as an offset of the current position.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be moved. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>LeftToRightDisplayIds</maml:name> <maml:description> <maml:para>Places the specified displays side by side, placing the first display as far left as possible, the second display right next to it, and so on. Every active display needs to be specified.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Position</maml:name> <maml:description> <maml:para>The position where the specified display should be placed, relative to the display specified with `-RelativeDisplayId`.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">RelativePosition</command:parameterValue> <dev:type> <maml:name>RelativePosition</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>RelativeDisplayId</maml:name> <maml:description> <maml:para>Specifies the display that the `-Position` parameter refers to.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>XPosition</maml:name> <maml:description> <maml:para>Specifies either the literal (default) or relative (when used with `-AsOffset`) X (horizontal) position where the display should be moved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>YPosition</maml:name> <maml:description> <maml:para>Specifies either the literal (default) or relative (when used with `-AsOffset`) Y (vertical) position where the display should be moved.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>SwapDisplay</maml:name> <maml:description> <maml:para>The displayIDs of the 2 displays whose position should be swapped. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayPosition -LeftToRightDisplayIds 2,1,3 -ApplyNow</dev:code> <dev:remarks> <maml:para>Positions displays 1,2,3 side by side with 2 being all the way to the left, 1 being in the middle and 3 being all the way to the right.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayPosition -LeftToRightDisplayIds 2,1,3 -ApplyNow</dev:code> <dev:remarks> <maml:para>Positions displays 1,2,3 side by side with 2 being all the way to the left, 1 being in the middle and 3 being all the way to the right.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 2 --------------------------</maml:title> <dev:code>PS C:\> Get-DisplayConfig | Set-DisplayPosition -DisplayId 1 -Position Above -RelativeDisplayId 2 | Set-DisplayPosition -DisplayId 3 -Position Above -RelativeDisplayId 1 | Use-DisplayConfig</dev:code> <dev:remarks> <maml:para>Displays 1,2,3 are currently side by side. This config stacks the displays on top of each other with 2 at the bottom, 1 in the middle and 3 at the top.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 3 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayPosition -DisplayId 3 -XPosition 0 -YPosition 100 -AsOffset</dev:code> <dev:remarks> <maml:para>Moves display 3 100 pixels down from its current position.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayPrimary</command:name> <command:verb>Set</command:verb> <command:noun>DisplayPrimary</command:noun> <maml:description> <maml:para>Sets the specified display as the primary display.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Sets the specified display as the primary display.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayPrimary</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be made primary. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayPrimary</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be made primary. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display that should be made primary. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayPrimary -DisplayId 2</dev:code> <dev:remarks> <maml:para>Sets the second display as the primary display.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayProfile</command:name> <command:verb>Set</command:verb> <command:noun>DisplayProfile</command:noun> <maml:description> <maml:para>Changes the active display profile. This works the same way the Windows key + P does.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Changes the active display profile. This works the same way the Windows key + P does.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayProfile</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Profile</maml:name> <maml:description> <maml:para>The profile to use.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">Internal</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Clone</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Extend</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">External</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">TopologyProfile</command:parameterValue> <dev:type> <maml:name>TopologyProfile</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Profile</maml:name> <maml:description> <maml:para>The profile to use.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">TopologyProfile</command:parameterValue> <dev:type> <maml:name>TopologyProfile</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayProfile Clone</dev:code> <dev:remarks> <maml:para>Switches to the most recent clone configuration.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayRefreshRate</command:name> <command:verb>Set</command:verb> <command:noun>DisplayRefreshRate</command:noun> <maml:description> <maml:para>Changes the refresh rate of the specified display.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Changes the refresh rate of the specified display.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayRefreshRate</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the refresh rate should be changed. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>RefreshRate</maml:name> <maml:description> <maml:para>The refresh rate to set.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Double</command:parameterValue> <dev:type> <maml:name>Double</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allows Windows to slightly adjust the specified refresh rate so it matches the monitor. This is highly recommended because displays often require decimal numbers like "59.951" rather than round numbers like "60".</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayRefreshRate</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the refresh rate should be changed. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>RefreshRate</maml:name> <maml:description> <maml:para>The refresh rate to set.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Double</command:parameterValue> <dev:type> <maml:name>Double</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allows Windows to slightly adjust the specified refresh rate so it matches the monitor. This is highly recommended because displays often require decimal numbers like "59.951" rather than round numbers like "60".</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the refresh rate should be changed. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>RefreshRate</maml:name> <maml:description> <maml:para>The refresh rate to set.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Double</command:parameterValue> <dev:type> <maml:name>Double</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayRefreshRate -DisplayId 2 -RefreshRate 165</dev:code> <dev:remarks> <maml:para>Sets the refresh rate to 165 Hz for display 2.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayResolution</command:name> <command:verb>Set</command:verb> <command:noun>DisplayResolution</command:noun> <maml:description> <maml:para>Sets the resolution of the specified displays.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Sets the resolution of the specified displays.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayResolution</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the resolution should be changed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Width</maml:name> <maml:description> <maml:para>Specifies the width of the resolution, meaning the first number in the common "1920 x 1080" format.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>Height</maml:name> <maml:description> <maml:para>Specifies the height of the resolution, meaning the second number in the common "1920 x 1080" format.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayResolution</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the resolution should be changed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Width</maml:name> <maml:description> <maml:para>Specifies the width of the resolution, meaning the first number in the common "1920 x 1080" format.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>Height</maml:name> <maml:description> <maml:para>Specifies the height of the resolution, meaning the second number in the common "1920 x 1080" format.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the resolution should be changed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none"> <maml:name>Height</maml:name> <maml:description> <maml:para>Specifies the height of the resolution, meaning the second number in the common "1920 x 1080" format.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Width</maml:name> <maml:description> <maml:para>Specifies the width of the resolution, meaning the first number in the common "1920 x 1080" format.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayResolution -DisplayId 3 -Width 1600 -Height 900</dev:code> <dev:remarks> <maml:para>Changes the resolution of display 3 to 1600 x 900.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayRotation</command:name> <command:verb>Set</command:verb> <command:noun>DisplayRotation</command:noun> <maml:description> <maml:para>Rotates the image of a display so it matches the physical setup.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Rotates the image of a display so it matches the physical setup.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayRotation</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) that should be rotated. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Rotation</maml:name> <maml:description> <maml:para>The amount of rotation in degrees (counterclockwise) that the display(s) should be rotated.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">None</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Rotate90</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Rotate180</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Rotate270</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">DisplayRotation</command:parameterValue> <dev:type> <maml:name>DisplayRotation</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayRotation</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) that should be rotated. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Rotation</maml:name> <maml:description> <maml:para>The amount of rotation in degrees (counterclockwise) that the display(s) should be rotated.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">None</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Rotate90</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Rotate180</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">Rotate270</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">DisplayRotation</command:parameterValue> <dev:type> <maml:name>DisplayRotation</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The displayConfig where this setting should be applied. See the help for `Get-DisplayConfig` for more info.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) that should be rotated. DisplayIds in this module use a similar logic as the Windows Settings app to number the displays, but there's no guarantee that it will match on every system. Displays are sorted by the output port on the adapter with the following priority: Internal displays (laptops), PC connectors (DVI, Displayport), HDMI and others. When multiple displays use the same connector (eg. 2 DisplayPort monitors) Windows will assign an incrementing number for each instance, and this number is combined with the priority to determine the exact display order. The only way to change the displayId of a display is to move it to a different port on the graphics adapter.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Rotation</maml:name> <maml:description> <maml:para>The amount of rotation in degrees (counterclockwise) that the display(s) should be rotated.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayRotation</command:parameterValue> <dev:type> <maml:name>DisplayRotation</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayRotation -DisplayId 3 -Rotation Rotate90</dev:code> <dev:remarks> <maml:para>Rotates the third display 90 degrees counterclockwise.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Set-DisplayScale</command:name> <command:verb>Set</command:verb> <command:noun>DisplayScale</command:noun> <maml:description> <maml:para>Changes the DPI for the specified display(s).</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Changes the DPI for the specified display(s).</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Set-DisplayScale</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the DPI should be changed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Recommended</maml:name> <maml:description> <maml:para>Sets the DPI to whatever Windows recommends. The DPI recommendation by Windows depends on the screen size, resolution and expected viewing distance.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Set-DisplayScale</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the DPI should be changed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Scale</maml:name> <maml:description> <maml:para>The DPI scale to set.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">100</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">125</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">150</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">175</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">200</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">225</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">250</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">300</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">350</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">400</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">450</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">500</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>DisplayId</maml:name> <maml:description> <maml:para>The display(s) where the DPI should be changed.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32[]</command:parameterValue> <dev:type> <maml:name>UInt32[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Recommended</maml:name> <maml:description> <maml:para>Sets the DPI to whatever Windows recommends. The DPI recommendation by Windows depends on the screen size, resolution and expected viewing distance.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Scale</maml:name> <maml:description> <maml:para>The DPI scale to set.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">UInt32</command:parameterValue> <dev:type> <maml:name>UInt32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Set-DisplayScale -DisplayId 1,2 -Scale 100</dev:code> <dev:remarks> <maml:para>Sets the DPI scale to 100 for displays 1 and 2.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Undo-DisplayConfigChanges</command:name> <command:verb>Undo</command:verb> <command:noun>DisplayConfigChanges</command:noun> <maml:description> <maml:para>Reverts any temporary display settings by resetting the display settings to the ones saved in the configuration database.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Reverts any temporary display settings by resetting the display settings to the ones saved in the configuration database. Temporary display settings can be set by using the `DontSave` parameter on supported commands. For a list of supported commands, see: `Get-Command -Module DisplayConfig -ParameterName DontSave`</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Undo-DisplayConfigChanges</maml:name> </command:syntaxItem> </command:syntax> <command:parameters /> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Undo-DisplayConfigChanges</dev:code> <dev:remarks> <maml:para>Reverts any temporary display settings by resetting the display settings to the ones saved in the configuration database.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Use-DisplayConfig</command:name> <command:verb>Use</command:verb> <command:noun>DisplayConfig</command:noun> <maml:description> <maml:para>Applies the specified Display topology settings.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Applies the specified Display topology settings.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Use-DisplayConfig</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to make slight adjustments to the configuration (readjusting desktop positions, changing the refresh rate, etc.). If this is not set, and the configuration contains invalid data then an error will be thrown.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The DisplayConfig to apply.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Flags</maml:name> <maml:description> <maml:para>Only for advanced users! You can read what each flag does, and how they interact here: https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-setdisplayconfig#parameters</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" command:variableLength="false">SDC_TOPOLOGY_INTERNAL</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_TOPOLOGY_CLONE</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_TOPOLOGY_EXTEND</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_TOPOLOGY_EXTERNAL</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_USE_DATABASE_CURRENT</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_TOPOLOGY_SUPPLIED</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_USE_SUPPLIED_DISPLAY_CONFIG</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_VALIDATE</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_APPLY</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_NO_OPTIMIZATION</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_SAVE_TO_DATABASE</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_ALLOW_CHANGES</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_PATH_PERSIST_IF_REQUIRED</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_FORCE_MODE_ENUMERATION</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_ALLOW_PATH_ORDER_CHANGES</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_VIRTUAL_MODE_AWARE</command:parameterValue> <command:parameterValue required="false" command:variableLength="false">SDC_VIRTUAL_REFRESH_RATE_AWARE</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">SetDisplayConfigFlags</command:parameterValue> <dev:type> <maml:name>SetDisplayConfigFlags</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>UpdateAdapterIds</maml:name> <maml:description> <maml:para>Gets the current display adapter IDs and updates the display config to use those before applying the config. This is useful if the displayconfig has been imported from a file because Windows may have changed the IDs since the file was exported.</maml:para> </maml:description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>AllowChanges</maml:name> <maml:description> <maml:para>Allow Windows to make slight adjustments to the configuration (readjusting desktop positions, changing the refresh rate, etc.). If this is not set, and the configuration contains invalid data then an error will be thrown.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none"> <maml:name>DisplayConfig</maml:name> <maml:description> <maml:para>The DisplayConfig to apply.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">DisplayConfig</command:parameterValue> <dev:type> <maml:name>DisplayConfig</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>DontSave</maml:name> <maml:description> <maml:para>Skips saving this configuration change to the configuration database, allowing you to roll back the changes with: `Undo-DisplayConfigChanges`.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Flags</maml:name> <maml:description> <maml:para>Only for advanced users! You can read what each flag does, and how they interact here: https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-setdisplayconfig#parameters</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">SetDisplayConfigFlags</command:parameterValue> <dev:type> <maml:name>SetDisplayConfigFlags</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>UpdateAdapterIds</maml:name> <maml:description> <maml:para>Gets the current display adapter IDs and updates the display config to use those before applying the config. This is useful if the displayconfig has been imported from a file because Windows may have changed the IDs since the file was exported.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>MartinGC94.DisplayConfig.API.DisplayConfig</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para> </maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Import-Clixml $HOME\TvProfile.xml | Use-DisplayConfig -UpdateAdapterIds</dev:code> <dev:remarks> <maml:para>Imports a profile that was stored on the filesystem and applies it to the current configuration.</maml:para> <maml:para /> <maml:para /> </dev:remarks> </command:example> </command:examples> <command:relatedLinks /> </command:command> </helpItems> |