You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: skype/skype-ps/skype/New-CsEdgeAllowList.md
+19-25Lines changed: 19 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ schema: 2.0.0
9
9
10
10
## SYNOPSIS
11
11
Enables administrators to specify the domains that their users will be allowed to communicate with.
12
-
The New-CsEdgeAllowList cmdlet, which can be used only with Skype for Business Online, must be used in conjunction with the New-CsEdgeDomainPattern cmdlet and the Set-CsTenantFederationConfiguration cmdlet.
12
+
The `New-CsEdgeAllowList` cmdlet, which can be used only with Skype for Business Online, must be used in conjunction with the `New-CsEdgeDomainPattern` cmdlet and the `Set-CsTenantFederationConfiguration` cmdlet.
13
13
14
14
## SYNTAX
15
15
@@ -32,20 +32,20 @@ However, administrators can modify this default setting and limit communication
32
32
33
33
Skype for Business Online does not allow you to directly modify the allowed list or the blocked list; for example, you cannot use a command similar to this one, which passes a string value representing a ___domain name to the allowed domains list:
Instead, you must use either the New-CsEdgeAllowAllKnownDomains cmdlet or the New-CsEdgeAllowList cmdlet to create a ___domain object and then pass that ___domain object to the Set-CsTenantFederationConfiguration cmdlet.
38
-
The New-CsEdgeAllowAllKnownDomains cmdlet is used if you want to allow users to communicate with all domains except for those expressly specified on the blocked domains list.
39
-
The New-CsEdgeAllowList cmdlet is used if you want to limit user communication to a specified collection of domains.
37
+
Instead, you must use either the `New-CsEdgeAllowAllKnownDomains` cmdlet or the `New-CsEdgeAllowList` cmdlet to create a ___domain object and then pass that ___domain object to the `Set-CsTenantFederationConfiguration` cmdlet.
38
+
The `New-CsEdgeAllowAllKnownDomains` cmdlet is used if you want to allow users to communicate with all domains except for those expressly specified on the blocked domains list.
39
+
The `New-CsEdgeAllowList` cmdlet is used if you want to limit user communication to a specified collection of domains.
40
40
In that case, users will only be allowed to communicate with domains that appear on the allowed domains list.
41
41
42
42
To add a single ___domain (fabrikam.com) to the allowed ___domain list, you need to use a set of command similar to these:
The commands shown in Example 1 assign the ___domain fabrikam.com to the allowed domains list for the tenant with the TenantId "bf19b7db-6960-41e5-a139-2aa373474354".
65
-
To do this, the first command in the example uses the New-CsEdgeDomainPattern cmdlet to create a ___domain object for fabrikam.com; this object is stored in a variable named $x.
66
-
After the ___domain object has been created, the New-CsEdgeAllowList cmdlet is used to create a new allowed list containing only the ___domain fabrikam.com.
65
+
To do this, the first command in the example uses the `New-CsEdgeDomainPattern` cmdlet to create a ___domain object for fabrikam.com; this object is stored in a variable named $x.
66
+
After the ___domain object has been created, the `New-CsEdgeAllowList` cmdlet is used to create a new allowed list containing only the ___domain fabrikam.com.
67
67
68
-
With the allowed ___domain list created, the final command in the example can then use the Set-CsTenantFederationConfiguration cmdlet to configure fabrikam.com as the only ___domain on the allowed ___domain list for the current tenant.
68
+
With the allowed ___domain list created, the final command in the example can then use the `Set-CsTenantFederationConfiguration` cmdlet to configure fabrikam.com as the only ___domain on the allowed ___domain list for the current tenant.
69
69
70
70
71
71
### -------------------------- Example 2 --------------------------
Example 2 shows how you can add multiple domains to an allowed domains list.
85
-
This is done by calling the New-CsEdgeDomainPattern cmdlet multiple times (one for each ___domain to be added to the list), and storing the resulting ___domain objects in separate variables.
86
-
Each of those variables can then be added to the allow list created by the New-CsEdgeAllowList cmdlet simply by using the AllowedDomain parameter and separating the variables name by using commas:
87
-
88
-
85
+
This is done by calling the `New-CsEdgeDomainPattern` cmdlet multiple times (one for each ___domain to be added to the list), and storing the resulting ___domain objects in separate variables.
86
+
Each of those variables can then be added to the allow list created by the `New-CsEdgeAllowList` cmdlet simply by using the AllowedDomain parameter and separating the variables name by using commas.
89
87
90
88
### -------------------------- Example 3 --------------------------
In Example 3, all domains are removed from the allowed domains list.
98
-
To do this, the first command in the example uses the New-CsEdgeAllowList cmdlet to create a blank list of allowed domains; this is accomplished by setting the AllowedDomain property to a null value ($Null).
99
-
The resulting object reference ($newAllowList) is then used in conjunction with the Set-CsTenantFederationConfiguration cmdlet to remove all the domains from the allowed ___domain list
100
-
101
-
96
+
To do this, the first command in the example uses the `New-CsEdgeAllowList` cmdlet to create a blank list of allowed domains; this is accomplished by setting the AllowedDomain property to a null value ($Null).
97
+
The resulting object reference ($newAllowList) is then used in conjunction with the `Set-CsTenantFederationConfiguration` cmdlet to remove all the domains from the allowed ___domain list.
102
98
103
99
## PARAMETERS
104
100
105
101
### -AllowedDomain
106
102
Object reference to the new ___domain (or set of domains) to be added to the allowed ___domain list.
107
-
Domain object references must be created by using the New-CsEdgeDomainPattern cmdlet.
103
+
Domain object references must be created by using the `New-CsEdgeDomainPattern` cmdlet.
108
104
Multiple ___domain objects can be added by separating the object references using commas.
109
105
For example:
110
106
111
-
`-AllowedDomain $x,$y`
107
+
-AllowedDomain $x,$y
112
108
113
109
```yaml
114
110
Type: Object
@@ -146,12 +142,12 @@ This cmdlet supports the common parameters: `-Debug, -ErrorAction, -ErrorVariabl
146
142
147
143
###
148
144
None.
149
-
The New-CsEdgeAllowList cmdlet does not accept pipelined input.
145
+
The `New-CsEdgeAllowList` cmdlet does not accept pipelined input.
150
146
151
147
## OUTPUTS
152
148
153
149
###
154
-
The New-CsEdgeAllowList cmdlet creates new instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowList object.
150
+
The `New-CsEdgeAllowList` cmdlet creates new instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowList object.
155
151
156
152
## NOTES
157
153
@@ -160,5 +156,3 @@ The New-CsEdgeAllowList cmdlet creates new instances of the Microsoft.Rtc.Manage
0 commit comments