Disable-CsComputer
Disables a service or server role that has been removed from a computer running Skype for Business Server. This cmdlet was introduced in Lync Server 2010.
Syntax
Disable-CsComputer
[-Scorch]
[-GlobalCatalog <Fqdn>]
[-Report <String>]
[-Force]
[-WhatIf]
[-Confirm]
[-GlobalSettingsDomainController <Fqdn>]
[<CommonParameters>] Description
Removing a service or server role from a computer does not automatically update the Skype for Business Server topology. Instead, that service or role must be disabled before the changes are fully updated in the topology. The Disable-CsComputer cmdlet provides a way for administrators to disable any services or server roles that have been removed from the local computer.
Unless you use the Scorch parameter, the Disable-CsComputer cmdlet does not uninstall the Skype for Business Server software; instead, it simply stops the computer from functioning in its previously assigned role.
You must be a local administrator and a member of the ___domain in order to run the Disable-CsComputer cmdlet locally.
Examples
-------------------------- Example 1 --------------------------
Disable-CsComputerThe command shown in Example 1 disables the local computer.
-------------------------- Example 2 --------------------------
Disable-CsComputer -Report C:\Logs\Disable.htmlThe command shown in Examples 2 also disables the local computer. In addition to disabling the computer, however, this command records information about the success (or failure) of that task in the file C:\Logs\Disable.html. This log file is generated by adding the Report parameter followed by the path to the log file where you want the information recorded.
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 |
-GlobalCatalog
Fully qualified ___domain name (FQDN) of a global catalog server in your ___domain. This parameter is not required if you are running the Disable-CsComputer cmdlet on a computer with an account in your ___domain.
| Type: | Fqdn |
| 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 |
-GlobalSettingsDomainController
FQDN of a ___domain controller where global settings are stored. If global settings are stored in the System container in Active Directory Domain Services, then this parameter must point to the root ___domain controller. If global settings are stored in the Configuration container, then any ___domain controller can be used and this parameter can be omitted.
| Type: | Fqdn |
| 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 |
-Report
Enables you to specify a file path for the log file created when the cmdlet runs. For example:
-Report "C:\Logs\DisableComputer.html"
| Type: | String |
| 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 |
-Scorch
Uninstalls all Skype for Business Server services and server roles for the local computer.
| 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 |
-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
None
Outputs
None
Instead, Disable-CsComputer disables instances of the Microsoft.Rtc.Management.Deploy.Internal.Machine object.