Merge pull request #3949 from Xelu86/update_networkatc

Update NetworkATC modules for WS2025

Author: Xelu86

docset/winserver2025-ps/NetworkATC/Add-NetIntent.md

@@ -1,7 +1,7 @@
----
+---
 external help file: NetworkAtc-help.xml
 Module Name: NetworkATC
-ms.date: 02/21/2024
+ms.date: 03/14/2025
 online version: https://learn.microsoft.com/powershell/module/networkatc/copy-netintent?view=windowsserver2025-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Copy-NetIntent
@@ -10,7 +10,7 @@ title: Copy-NetIntent
 # Copy-NetIntent
 
 ## SYNOPSIS
-Moves (or copies) net intent across different hosts or clusters
+Moves or copies network intents across different hosts or clusters.
 
 ## SYNTAX
 
@@ -72,136 +72,146 @@ Copy-NetIntent [-GlobalOverrides] [-SourceComputerName] <String> [-DestinationCo
 
 ## DESCRIPTION
 
-{{ Fill in the Description }}
+The `Copy-NetIntent` cmdlet copies or moves a network intent from one host or
+cluster to another. The source intent is removed if the **RemoveSource**
+parameter is provided.
 
 ## EXAMPLES
 
 ### EXAMPLE 1
 
+```powershell
+Copy-NetIntent -Name "MyIntent" -SourceComputerName "Server01" -DestinationComputerName "Server02"
 ```
-Copy-NetIntent
-```
+
+This example copies a network intent from the standalone device `Server01` to
+the standalone destination device `Server02`.
 
 ## PARAMETERS
 
-### -DestinationClusterName
+### -Name
 
-The name of the cluster that the intent is copied to.
+Defines a unique name that identifies the network intent. Since intents are
+uniquely determined by their list of physical adapters, the name is used as an
+identifier to ensure that each intent is distinct.
 
 ```yaml
-Type: System.String
-Parameter Sets: ClusterToCluster, LocalToCluster, GlobalClusterToCluster, GlobalLocalToCluster
+Type: String
+Parameter Sets: LocalToLocal, ClusterToCluster, ClusterToLocal, LocalToCluster
 Aliases:
 
-Required: True
-Position: 3
+Required: False
+Position: 1
 Default value: None
-Accept pipeline input: False
+Accept pipeline input: True (ByPropertyName, ByValue)
 Accept wildcard characters: False
 ```
 
-### -DestinationComputerName
+### -GlobalOverrides
 
-The name of the computer that the intent is copied to.
+Specifies that global override settings during the copy operation for any local
+settings.
 
 ```yaml
-Type: System.String
-Parameter Sets: LocalToLocal, ClusterToLocal, GlobalClusterToLocal, GlobalLocalToLocal
+Type: SwitchParameter
+Parameter Sets: GlobalClusterToLocal, GlobalClusterToCluster, GlobalLocalToCluster, GlobalLocalToLocal
 Aliases:
 
 Required: True
-Position: 3
-Default value: None
-Accept pipeline input: False
+Position: Named
+Default value: False
+Accept pipeline input: True (ByPropertyName, ByValue)
 Accept wildcard characters: False
 ```
 
-### -GlobalOverrides
+### -SourceComputerName
 
-{{ Fill GlobalOverrides Description }}
+Specifies the name of the source computer that holds the network intent to be copied.
 
 ```yaml
-Type: System.Management.Automation.SwitchParameter
-Parameter Sets: GlobalClusterToLocal, GlobalClusterToCluster, GlobalLocalToCluster, GlobalLocalToLocal
+Type: String
+Parameter Sets: LocalToLocal, LocalToCluster, GlobalLocalToCluster, GlobalLocalToLocal
 Aliases:
 
 Required: True
-Position: Named
-Default value: False
-Accept pipeline input: True (ByPropertyName, ByValue)
+Position: 2
+Default value: None
+Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -Name
+### -SourceClusterName
 
-The name of the intent to be copied.
+Specifies the name of the source cluster that contains the network intent to be copied.
 
 ```yaml
-Type: System.String
-Parameter Sets: LocalToLocal, ClusterToCluster, ClusterToLocal, LocalToCluster
+Type: String
+Parameter Sets: ClusterToCluster, ClusterToLocal, GlobalClusterToLocal, GlobalClusterToCluster
 Aliases:
 
-Required: False
-Position: 1
+Required: True
+Position: 2
 Default value: None
-Accept pipeline input: True (ByPropertyName, ByValue)
+Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -RemoveSource
+### -DestinationComputerName
 
-Indicates that the source needs to be removed after the copy.
+Specifies the name of the destination computer where the network intent is to be copied.
 
 ```yaml
-Type: System.Boolean
-Parameter Sets: (All)
+Type: String
+Parameter Sets: LocalToLocal, ClusterToLocal, GlobalClusterToLocal, GlobalLocalToLocal
 Aliases:
 
-Required: False
-Position: Named
-Default value: False
+Required: True
+Position: 3
+Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -SourceClusterName
+### -DestinationClusterName
 
-The name of the cluster that the intent is copied from.
+Specifies the name of the destination cluster to which the network intent is to be copied.
 
 ```yaml
-Type: System.String
-Parameter Sets: ClusterToCluster, ClusterToLocal, GlobalClusterToLocal, GlobalClusterToCluster
+Type: String
+Parameter Sets: ClusterToCluster, LocalToCluster, GlobalClusterToCluster, GlobalLocalToCluster
 Aliases:
 
 Required: True
-Position: 2
+Position: 3
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -SourceComputerName
+### -RemoveSource
 
-The name of the computer that the intent is copied from.
+Indicates whether the original network intent should be removed from the source
+after the copy operation is completed.
 
 ```yaml
-Type: System.String
-Parameter Sets: LocalToLocal, LocalToCluster, GlobalLocalToCluster, GlobalLocalToLocal
+Type: Boolean
+Parameter Sets: (All)
 Aliases:
 
-Required: True
-Position: 2
-Default value: None
+Required: False
+Position: Named
+Default value: False
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
 ### -Wait
 
-{{ Fill Wait Description }}
+When specified, the command will wait for the network configuration commands to
+complete or for status confirmation before returning control.
 
 ```yaml
-Type: System.Management.Automation.SwitchParameter
+Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:
 
@@ -214,14 +224,28 @@ Accept wildcard characters: False
 
 ### CommonParameters
 
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+This cmdlet supports the common parameters: -Debug, -ErrorAction,
+-ErrorVariable, -InformationAction, -InformationVariable, -OutVariable,
+-OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
+For more information, see
+[about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
 
 ## INPUTS
 
 ## OUTPUTS
 
 ## NOTES
 
-The copy & removal operation of the intent is not a transacted operation\`.
+The copy and removal operation of the intent isn't a transacted operation.
 
 ## RELATED LINKS
+
+- [Add-NetIntent](Add-NetIntent.md)
+
+- [Get-NetIntent](Get-NetIntent.md)
+
+- [Get-NetIntentStatus](Get-NetIntentStatus.md)
+
+- [Remove-NetIntent](Remove-NetIntent.md)
+
+- [Set-NetIntent](Set-NetIntent.md)

docset/winserver2025-ps/NetworkATC/Copy-NetIntent.md

@@ -1,7 +1,7 @@
----
+---
 external help file: NetworkAtc-help.xml
 Module Name: NetworkATC
-ms.date: 02/21/2024
+ms.date: 03/14/2025
 online version: https://learn.microsoft.com/powershell/module/networkatc/get-allnetintents?view=windowsserver2025-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Get-AllNetIntents
@@ -10,7 +10,7 @@ title: Get-AllNetIntents
 # Get-AllNetIntents
 
 ## SYNOPSIS
-Looks up all intent requests configurations available
+Looks up all intent request configurations available.
 
 ## SYNTAX
 
@@ -21,26 +21,28 @@ Get-AllNetIntents [[-ClusterName] <String>] [[-ComputerName] <String>] [-GlobalO
 
 ## DESCRIPTION
 
-{{ Fill in the Description }}
+The `Get-AllNetIntents` cmdlet retrieves all network intent configurations
+available based on the computer name or cluster name.
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
-PS C:\> {{ Add example code here }}
+Get-AllNetIntents -ComputerName "Server01"
 ```
 
-{{ Add example description here }}
+This example retrieves all network intent configurations from the `Server01` standalone host.
 
 ## PARAMETERS
 
 ### -ClusterName
 
-{{ Fill ClusterName Description }}
+Specifies the name of the cluster for which the network intent is to be
+retrieved. When used, the intent "floats" across the cluster.
 
 ```yaml
-Type: System.String
+Type: String
 Parameter Sets: (All)
 Aliases:
 
@@ -53,10 +55,13 @@ Accept wildcard characters: False
 
 ### -ComputerName
 
-{{ Fill ComputerName Description }}
+Specifies the computer name of the target host on which the network
+intent configuration is to be retrieved. For standalone hosts, use the local
+computer name; for scenarios where the script is executed remotely, ensure the
+current user has administrative privileges on the target machine.
 
 ```yaml
-Type: System.String
+Type: String
 Parameter Sets: (All)
 Aliases:
 
@@ -69,10 +74,10 @@ Accept wildcard characters: False
 
 ### -GlobalOverrides
 
-{{ Fill GlobalOverrides Description }}
+Retrieves the global override settings.
 
 ```yaml
-Type: System.Management.Automation.SwitchParameter
+Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:
 
@@ -85,10 +90,11 @@ Accept wildcard characters: False
 
 ### CommonParameters
 
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
--InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
--WarningAction, and -WarningVariable. For more information, see
-[about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+This cmdlet supports the common parameters: -Debug, -ErrorAction,
+-ErrorVariable, -InformationAction, -InformationVariable, -OutVariable,
+-OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
+For more information, see
+[about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
 
 ## INPUTS