Add-SCACCloudSystem
Add-SCACCloudSystem
Adds a new connection to a VMM management server or service provider.
Syntax
Parameter Set: SPF
Add-SCACCloudSystem [-Name] <String> [-ServiceLocation] <Uri> [-CertificateFilePath] <String> [-CertificatePassword] <SecureString> -SPF [-Description <String> ] [ <CommonParameters>]
Parameter Set: VMM
Add-SCACCloudSystem [-Name] <String> [-ServerName] <String> [-Port] <Int32> -VMM [-Description <String> ] [ <CommonParameters>]
Detailed Description
The Add-SCACCloudSystem function adds a new connection to a VMM management server or service provider.
Parameters
-CertificateFilePath<String>
Specifies a file path to the certificate.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-CertificatePassword<SecureString>
Specifies a secure string that contains a password for the certificate.
Aliases |
none |
Required? |
true |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Description<String>
Specifies a description for the connection.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name for the cloud system.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Port<Int32>
Specifies the port to be used for the connection.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ServerName<String>
Specifies the name of a VMM management server.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ServiceLocation<Uri>
Specifies the service location URI.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-SPF
Indicates that the connection is made with .
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-VMM
Indicates that the connection is made with a VMM management server.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
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
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
This command adds a connection named CloudSystem01 to the VMM management server named VMMServer01 using port 8100.
PS C:\> Add-SCACCloudsystem -Name "VMMCloudSystem01" -VMM -ServerName "VMMServer01.Contoso.com" -Port 8100
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
The first command creates a secure string for the provided password and stores the secure string in the $Password variable.
The second command adds a service provider connection.
PS C:\> $Password = ConvertTo-SecureString "PassWord!" -AsPlainText -Force
PS C:\> Add-SCACCloudsystem -Name "ServiceProvider01" -ServiceLocation "https://Server01.contoso.com:8090/SC2012/VMM/Microsoft.Management.OData.svc/4deca2d5-6169-49ca-aa7a-efd6e4b372a3" -CertificateFilePath "\\FileServer01\Certs\TenantCert.pfx" -CertificatePassword $Password -SPF