Add-SCACCloudSystem

Article
11/18/2013

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

Get-SCACCloudSystem

Set-SCACCloudSystem

Remove-SCACCloudSystem

Add-SCACCloudSystem