Skip to content

Commit d6a5a84

Browse files
authored
Merge pull request MicrosoftDocs#2592 from TimShererWithAquent/netsec-v-tishe
NetSecurity PowerShell reference update
2 parents 9bd3371 + 4a3bd34 commit d6a5a84

13 files changed

+1084
-354
lines changed

docset/winserver2022-ps/netsecurity/Copy-NetFirewallRule.md

Lines changed: 34 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,21 @@ Copies an entire firewall rule, and associated filters, to the same or to a diff
1717

1818
### GetAll (Default)
1919
```
20-
Copy-NetFirewallRule [-All] [-PolicyStore <String>] [-GPOSession <String>] [-TracePolicyStore]
21-
[-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>]
22-
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
20+
Copy-NetFirewallRule [-All] [-PolicyStore <String>] [-TracePolicyStore] [-NewPolicyStore <String>]
21+
[-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
22+
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
2323
```
2424

2525
### ByName
2626
```
27-
Copy-NetFirewallRule [-Name] <String[]> [-PolicyStore <String>] [-GPOSession <String>] [-TracePolicyStore]
28-
[-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>]
29-
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
27+
Copy-NetFirewallRule [-Name] <String[]> [-PolicyStore <String>] [-TracePolicyStore] [-NewPolicyStore <String>]
28+
[-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
29+
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
3030
```
3131

3232
### ByDisplayName
3333
```
34-
Copy-NetFirewallRule -DisplayName <String[]> [-PolicyStore <String>] [-GPOSession <String>] [-TracePolicyStore]
34+
Copy-NetFirewallRule -DisplayName <String[]> [-PolicyStore <String>] [-TracePolicyStore]
3535
[-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>]
3636
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
3737
```
@@ -42,74 +42,71 @@ Copy-NetFirewallRule [-Description <String[]>] [-DisplayGroup <String[]>] [-Grou
4242
[-Enabled <Enabled[]>] [-Direction <Direction[]>] [-Action <Action[]>]
4343
[-EdgeTraversalPolicy <EdgeTraversal[]>] [-LooseSourceMapping <Boolean[]>] [-LocalOnlyMapping <Boolean[]>]
4444
[-Owner <String[]>] [-PrimaryStatus <PrimaryStatus[]>] [-Status <String[]>] [-PolicyStoreSource <String[]>]
45-
[-PolicyStoreSourceType <PolicyStoreType[]>] [-PolicyStore <String>] [-GPOSession <String>]
46-
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
47-
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
48-
[<CommonParameters>]
45+
[-PolicyStoreSourceType <PolicyStoreType[]>] [-PolicyStore <String>] [-TracePolicyStore]
46+
[-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>]
47+
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
4948
```
5049

5150
### ByAssociatedNetFirewallAddressFilter
5251
```
5352
Copy-NetFirewallRule -AssociatedNetFirewallAddressFilter <CimInstance> [-PolicyStore <String>]
54-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
55-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
56-
[-Confirm] [<CommonParameters>]
53+
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
54+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
55+
[<CommonParameters>]
5756
```
5857

5958
### ByAssociatedNetFirewallApplicationFilter
6059
```
6160
Copy-NetFirewallRule -AssociatedNetFirewallApplicationFilter <CimInstance> [-PolicyStore <String>]
62-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
63-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
64-
[-Confirm] [<CommonParameters>]
61+
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
62+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
63+
[<CommonParameters>]
6564
```
6665

6766
### ByAssociatedNetFirewallInterfaceFilter
6867
```
6968
Copy-NetFirewallRule -AssociatedNetFirewallInterfaceFilter <CimInstance> [-PolicyStore <String>]
70-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
71-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
72-
[-Confirm] [<CommonParameters>]
69+
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
70+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
71+
[<CommonParameters>]
7372
```
7473

7574
### ByAssociatedNetFirewallInterfaceTypeFilter
7675
```
7776
Copy-NetFirewallRule -AssociatedNetFirewallInterfaceTypeFilter <CimInstance> [-PolicyStore <String>]
78-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
79-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
80-
[-Confirm] [<CommonParameters>]
77+
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
78+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
79+
[<CommonParameters>]
8180
```
8281

8382
### ByAssociatedNetFirewallPortFilter
8483
```
85-
Copy-NetFirewallRule -AssociatedNetFirewallPortFilter <CimInstance> [-PolicyStore <String>]
86-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
87-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
88-
[-Confirm] [<CommonParameters>]
84+
Copy-NetFirewallRule -AssociatedNetFirewallPortFilter <CimInstance> [-PolicyStore <String>] [-TracePolicyStore]
85+
[-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>]
86+
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
8987
```
9088

9189
### ByAssociatedNetFirewallSecurityFilter
9290
```
9391
Copy-NetFirewallRule -AssociatedNetFirewallSecurityFilter <CimInstance> [-PolicyStore <String>]
94-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
95-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
96-
[-Confirm] [<CommonParameters>]
92+
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
93+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
94+
[<CommonParameters>]
9795
```
9896

9997
### ByAssociatedNetFirewallServiceFilter
10098
```
10199
Copy-NetFirewallRule -AssociatedNetFirewallServiceFilter <CimInstance> [-PolicyStore <String>]
102-
[-GPOSession <String>] [-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>]
103-
[-NewName <String>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
104-
[-Confirm] [<CommonParameters>]
100+
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
101+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
102+
[<CommonParameters>]
105103
```
106104

107105
### ByAssociatedNetFirewallProfile
108106
```
109-
Copy-NetFirewallRule -AssociatedNetFirewallProfile <CimInstance> [-PolicyStore <String>] [-GPOSession <String>]
110-
[-TracePolicyStore] [-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>]
111-
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
112-
[<CommonParameters>]
107+
Copy-NetFirewallRule -AssociatedNetFirewallProfile <CimInstance> [-PolicyStore <String>] [-TracePolicyStore]
108+
[-NewPolicyStore <String>] [-NewGPOSession <String>] [-NewName <String>] [-CimSession <CimSession[]>]
109+
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
113110
```
114111

115112
### InputObject (cdxml)
@@ -523,28 +520,6 @@ Accept pipeline input: False
523520
Accept wildcard characters: False
524521
```
525522
526-
### -GPOSession
527-
Specifies the network GPO from which to retrieve the rules to be copied.
528-
This parameter is used in the same way as the *PolicyStore* parameter.
529-
When modifying GPOs in Windows PowerShell®, each change to a GPO requires the entire GPO to be loaded, modified, and saved back.
530-
On a busy Domain Controller (DC), this can be a slow and resource-heavy operation.
531-
A GPO Session loads a domain GPO onto the local computer, caches the updates, and saves the changes as a batch of transactions.
532-
This reduces the load on the DC and speeds up the Windows PowerShell cmdlets.
533-
To load a GPO Session, use the Open-NetGPO cmdlet.
534-
To save a GPO Session, use the Save-NetGPO cmdlet.
535-
536-
```yaml
537-
Type: String
538-
Parameter Sets: GetAll, ByName, ByDisplayName, ByQuery, ByAssociatedNetFirewallAddressFilter, ByAssociatedNetFirewallApplicationFilter, ByAssociatedNetFirewallInterfaceFilter, ByAssociatedNetFirewallInterfaceTypeFilter, ByAssociatedNetFirewallPortFilter, ByAssociatedNetFirewallSecurityFilter, ByAssociatedNetFirewallServiceFilter, ByAssociatedNetFirewallProfile
539-
Aliases:
540-
541-
Required: False
542-
Position: Named
543-
Default value: None
544-
Accept pipeline input: False
545-
Accept wildcard characters: False
546-
```
547-
548523
### -Group
549524
Specifies that only matching firewall rules of the indicated group association are copied.
550525
Wildcard characters are accepted.

docset/winserver2022-ps/netsecurity/Disable-NetFirewallRule.md

Lines changed: 26 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -17,23 +17,22 @@ Disables a firewall rule.
1717

1818
### GetAll (Default)
1919
```
20-
Disable-NetFirewallRule [-All] [-PolicyStore <String>] [-GPOSession <String>] [-TracePolicyStore]
21-
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
22-
[<CommonParameters>]
20+
Disable-NetFirewallRule [-All] [-PolicyStore <String>] [-TracePolicyStore] [-CimSession <CimSession[]>]
21+
[-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
2322
```
2423

2524
### ByName
2625
```
27-
Disable-NetFirewallRule [-Name] <String[]> [-PolicyStore <String>] [-GPOSession <String>] [-TracePolicyStore]
26+
Disable-NetFirewallRule [-Name] <String[]> [-PolicyStore <String>] [-TracePolicyStore]
2827
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
2928
[<CommonParameters>]
3029
```
3130

3231
### ByDisplayName
3332
```
34-
Disable-NetFirewallRule -DisplayName <String[]> [-PolicyStore <String>] [-GPOSession <String>]
35-
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
36-
[-Confirm] [<CommonParameters>]
33+
Disable-NetFirewallRule -DisplayName <String[]> [-PolicyStore <String>] [-TracePolicyStore]
34+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
35+
[<CommonParameters>]
3736
```
3837

3938
### ByQuery
@@ -42,65 +41,65 @@ Disable-NetFirewallRule [-Description <String[]>] [-DisplayGroup <String[]>] [-G
4241
[-Enabled <Enabled[]>] [-Direction <Direction[]>] [-Action <Action[]>]
4342
[-EdgeTraversalPolicy <EdgeTraversal[]>] [-LooseSourceMapping <Boolean[]>] [-LocalOnlyMapping <Boolean[]>]
4443
[-Owner <String[]>] [-PrimaryStatus <PrimaryStatus[]>] [-Status <String[]>] [-PolicyStoreSource <String[]>]
45-
[-PolicyStoreSourceType <PolicyStoreType[]>] [-PolicyStore <String>] [-GPOSession <String>]
46-
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
47-
[-Confirm] [<CommonParameters>]
44+
[-PolicyStoreSourceType <PolicyStoreType[]>] [-PolicyStore <String>] [-TracePolicyStore]
45+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
46+
[<CommonParameters>]
4847
```
4948

5049
### ByAssociatedNetFirewallAddressFilter
5150
```
5251
Disable-NetFirewallRule -AssociatedNetFirewallAddressFilter <CimInstance> [-PolicyStore <String>]
53-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
54-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
52+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
53+
[-Confirm] [<CommonParameters>]
5554
```
5655

5756
### ByAssociatedNetFirewallApplicationFilter
5857
```
5958
Disable-NetFirewallRule -AssociatedNetFirewallApplicationFilter <CimInstance> [-PolicyStore <String>]
60-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
61-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
59+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
60+
[-Confirm] [<CommonParameters>]
6261
```
6362

6463
### ByAssociatedNetFirewallInterfaceFilter
6564
```
6665
Disable-NetFirewallRule -AssociatedNetFirewallInterfaceFilter <CimInstance> [-PolicyStore <String>]
67-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
68-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
66+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
67+
[-Confirm] [<CommonParameters>]
6968
```
7069

7170
### ByAssociatedNetFirewallInterfaceTypeFilter
7271
```
7372
Disable-NetFirewallRule -AssociatedNetFirewallInterfaceTypeFilter <CimInstance> [-PolicyStore <String>]
74-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
75-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
73+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
74+
[-Confirm] [<CommonParameters>]
7675
```
7776

7877
### ByAssociatedNetFirewallPortFilter
7978
```
8079
Disable-NetFirewallRule -AssociatedNetFirewallPortFilter <CimInstance> [-PolicyStore <String>]
81-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
82-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
80+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
81+
[-Confirm] [<CommonParameters>]
8382
```
8483

8584
### ByAssociatedNetFirewallSecurityFilter
8685
```
8786
Disable-NetFirewallRule -AssociatedNetFirewallSecurityFilter <CimInstance> [-PolicyStore <String>]
88-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
89-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
87+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
88+
[-Confirm] [<CommonParameters>]
9089
```
9190

9291
### ByAssociatedNetFirewallServiceFilter
9392
```
9493
Disable-NetFirewallRule -AssociatedNetFirewallServiceFilter <CimInstance> [-PolicyStore <String>]
95-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
96-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
94+
[-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf]
95+
[-Confirm] [<CommonParameters>]
9796
```
9897

9998
### ByAssociatedNetFirewallProfile
10099
```
101-
Disable-NetFirewallRule -AssociatedNetFirewallProfile <CimInstance> [-PolicyStore <String>]
102-
[-GPOSession <String>] [-TracePolicyStore] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
103-
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
100+
Disable-NetFirewallRule -AssociatedNetFirewallProfile <CimInstance> [-PolicyStore <String>] [-TracePolicyStore]
101+
[-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm]
102+
[<CommonParameters>]
104103
```
105104

106105
### InputObject (cdxml)
@@ -515,28 +514,6 @@ Accept pipeline input: False
515514
Accept wildcard characters: False
516515
```
517516
518-
### -GPOSession
519-
Specifies the network GPO from which to retrieve the rules to be disabled.
520-
This parameter is used in the same way as the *PolicyStore* parameter.
521-
When modifying GPOs in Windows PowerShell®, each change to a GPO requires the entire GPO to be loaded, modified, and saved back.
522-
On a busy Domain Controller (DC), this can be a slow and resource-heavy operation.
523-
A GPO Session loads a domain GPO onto the local computer and makes all changes in a batch, before saving it back.
524-
This reduces the load on the DC and speeds up the Windows PowerShell cmdlets.
525-
To load a GPO Session, use the Open-NetGPO cmdlet.
526-
To save a GPO Session, use the Save-NetGPO cmdlet.
527-
528-
```yaml
529-
Type: String
530-
Parameter Sets: GetAll, ByName, ByDisplayName, ByQuery, ByAssociatedNetFirewallAddressFilter, ByAssociatedNetFirewallApplicationFilter, ByAssociatedNetFirewallInterfaceFilter, ByAssociatedNetFirewallInterfaceTypeFilter, ByAssociatedNetFirewallPortFilter, ByAssociatedNetFirewallSecurityFilter, ByAssociatedNetFirewallServiceFilter, ByAssociatedNetFirewallProfile
531-
Aliases:
532-
533-
Required: False
534-
Position: Named
535-
Default value: None
536-
Accept pipeline input: False
537-
Accept wildcard characters: False
538-
```
539-
540517
### -Group
541518
Specifies that only matching firewall rules of the indicated group association are disabled.
542519
Wildcard characters are accepted.

0 commit comments

Comments
 (0)