New-SCSPFServer
New-SCSPFServer
Registers a server in the Service Provider Foundation database.
Syntax
Parameter Set: Empty
New-SCSPFServer -Name <String> -ServerType <String> [-Stamps <Stamp[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The New-SCSPFServer cmdlet adds a server to the Service Provider Foundation database. Service Provider Foundation currently supports registering only VMM servers. The ServerType parameter must be set to 0 for a VMM server.
Parameters
-Name<String>
Specifies the name of the VMM server. Specify the fully qualified domain name (FQDN).
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ServerType<String>
Specifies the type of server. You can specify only 0 for Virtual Machine Manager (VMM) as the server type, other values are reserved for future use.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Stamps<Stamp[]>
Specifies the name of one or more stamp objects to associate with the new server. To obtain a stamp, use the Get-SCSPFStamp cmdlet.
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.
Examples
1: Add a server.
The first command gets a stamp.
The second command creates a server with a specified name, a VMM server type, and associates the server with the stamp.
PS C:\> $stmp = Get-SCSPFStamp -Name "UltimatePro"
PS C:\> New-SCSPFServer -Name "server23G" -ServerType 0 -Stamps $stmp