Remove-CsStaticRoutingConfiguration
Removes the specified collection of static routing configuration settings. This cmdlet was introduced in Lync Server 2010.
Syntax
Remove-CsStaticRoutingConfiguration
[-Identity] <XdsIdentity>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
When you send a SIP message to someone that message might need to traverse multiple subnets and networks before it is delivered; the path traveled by the message is often referred to as a route. In networking, there are two types of routes: dynamic and static. With dynamic routing, servers use algorithms to determine the next location (the next hop) where a message should be forwarded. With static routing, message paths are predetermined by system administrators. When a message is received by a server, the server checks the message address and then forwards the message to the next hop server that has been preconfigured by an administrator. If configured correctly, static routes help ensure timely and accurate, delivery of messages and with minimal overheard placed on servers. The downside to static routes is that messages are not dynamically rerouted in the event of a network failure.
When you install Skype for Business Server, a global collection of static routes is automatically created for you.
(The collection is created, but there are no routes assigned to that collection.) In addition, the software enables you to create additional collections applied to the service scope (these new collections can only be assigned to the Registrar service).
If you later change your mind, you can use the Remove-CsStaticRoutingConfiguration cmdlet to delete the collections applied to the service scope.
You can also run the Remove-CsStaticRoutingConfiguration cmdlet against the global collection.
In that case, however, the global collection will not be removed; Skype for Business Server does not allow you to remove global collections.
Instead, all the properties in the global collection will be reset to their default values.
That means that all the routes assigned to the global collection will be deleted.
Examples
-------------------------- Example 1 ------------------------
Remove-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"The command shown in Example 1 removes the static routing configuration collection that has the Identity service:Registrar:atl-cs-001.litwareinc.com.
-------------------------- Example 2 ------------------------
Get-CsStaticRoutingConfiguration -Filter "service:*" | Remove-CsStaticRoutingConfigurationIn Example 2, all the static routing configuration collections applied to the service scope are removed.
To do this, the command starts off by using the Get-CsStaticRoutingConfiguration cmdlet and the Filter parameter; the filter value "service:*" limits the returned data to collections that have an Identity that begins with the string value "service:".
This filtered collection is then piped to the Remove-CsStaticRoutingConfiguration cmdlet, which deletes each item in that collection.
-------------------------- Example 3 ------------------------
Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfigurationExample 3 shows how you can delete all the static routing configuration collections that have not been assigned any actual routes.
To perform this task, the command first calls the Get-CsStaticRoutingConfiguration cmdlet; this returns information about all the static routing collections in use in the organization.
This collection is then piped to the Where-Object cmdlet, which picks out only those collections where the number of routes (Route.Count) is equal to 0.
The filtered information is then piped to the Remove-CsStaticRoutingConfiguration cmdlet, which deletes each collection that has not been assigned at least one route.
Parameters
-Confirm
Prompts you for confirmation before executing the command.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Force
Suppresses the display of any non-fatal error message that might occur when running the command.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
Unique identifier of the static routing configuration collection to be removed. To remove a collection configured at the service scope, use syntax similar to this:
-Identity "service:Registrar:atl-cs-001.litwareinc.com"
The Remove-CsStaticRoutingConfiguration cmdlet can also be run against the global collection; to do so, use this syntax:
-Identity global
Keep in mind, however, that the global collection will not actually be removed. Instead, the properties in that collection will be reset to their default values. That means that all the items in the Route property will be deleted.
| Type: | XdsIdentity |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings object.
The Remove-CsStaticRoutingConfiguration cmdlet accepts pipelined instances of the static routing settings object.
Outputs
The Remove-CsStaticRoutingConfiguration cmdlet does not return a value or object.
Instead, the cmdlet deletes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings object.