Add-SCACCloudSystem
Applies To: System Center 2012 R2 App Controller
Add-SCACCloudSystem
Adds a 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> ] [-PassThru] [ <CommonParameters>]
Parameter Set: VMM
Add-SCACCloudSystem [-Name] <String> [-ServerName] <String> [-Port] <Int32> -VMM [-Description <String> ] [-PassThru] [ <CommonParameters>]
Detailed Description
The Add-SCACCloudSystem cmdlet 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>
Provides 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 |
-PassThru
Returns a cloud system object. By default, this cmdlet does not generate output.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Port<Int32>
Specifies a port to use 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 Provider Foundation 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 Service Provider Foundation.
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.
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: Add a connection to a VMM management server
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: Add a connection to a service provider
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