Start-WssConfigurationService
Start-WssConfigurationService
Starts initial configuration of Windows Server Essentials.
Syntax
Parameter Set: Default
Start-WssConfigurationService [-CompanyName <String> ] [-ComputerName <String> ] [-Credential <psCredential> ] [-DnsName <String> ] [-Force] [-Hosted] [-NetBiosName <String> ] [-NewAdminCredential <psCredential> ] [-Setting <String> {All | Updates | None} ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Start-WssConfigurationService cmdlet starts initial configuration of Windows Server Essentials.
Parameters
-CompanyName<String>
Specifies the name of the company for the server configuration. This dynamic parameter becomes available only if the server belongs to a workgroup.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ComputerName<String>
Specifies the name of a computer with which to work. The cmdlet renames the server with the name that you specify. This dynamic parameter becomes available only if the server belongs to a workgroup.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Credential<psCredential>
Specifies the credentials for the administrator account used to create the domain. This is required if you are not currently signed in as a user with the required permissions.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-DnsName<String>
Specifies the Domain Name System (DNS) name for the Active Directory® Domain Services domain to create. This dynamic parameter becomes available only if the server belongs to a workgroup.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Force
Forces the command to run without asking for user confirmation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Hosted
Indicates that the server is hosted in the cloud. This dynamic parameter becomes available only if the server belongs to a workgroup.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-NetBiosName<String>
Specifies the NetBIOS name for the Active Directory Domain Services domain to create. This dynamic parameter becomes available only if the server belongs to a workgroup.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-NewAdminCredential<psCredential>
Specifies the credentials for the administrator account that is created during the setup process.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Setting<String>
Specifies how to configure Windows Update on the server. The acceptable values for this parameter are:
-- All. Automatically download and install all updates for the Windows operating system.
-- Updates. Automatically download and install only critical and security updates for the Windows operating system.
-- None. Opt out of Windows Update.
This dynamic parameter becomes available only if the server belongs to a workgroup.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Microsoft.WindowsServerSolutions.Setup.ICCommon.StatusInfo
The cmdlet generates an object that represents the configuration status.
Examples
Example 1: Start initial configuration
This command starts initial configuration of Windows Server Essentials.
PS C:\> $cred = Get-Credential –UserName LocalAdmin –Message "Please specify the password for your new administrator account."
PS C:\> Start-WssConfigurationService -CompanyName "Contoso.Inc" -NetBiosName "contosodomain" -NewAdminCredential $cred