Add-SCACAzureSubscription
Applies To: System Center 2012 R2 App Controller
Add-SCACAzureSubscription
Adds a Windows Azure subscription to App Controller.
Syntax
Parameter Set: Default
Add-SCACAzureSubscription [-Name] <String> [-Id] <Guid> [-ManagementCertificatePath] <String> [-ManagementCertificatePassword] <SecureString> [[-Description] <String> ] [-PassThru] [ <CommonParameters>]
Detailed Description
The Add-SCACAzureSubscription cmdlet adds a Windows Azure subscription to App Controller.
Parameters
-Description<String>
Provides a description for the Windows Azure subscription.
Aliases |
none |
Required? |
false |
Position? |
5 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Id<Guid>
Specifies a GUID that represents the ID for a Windows Azure subscription.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ManagementCertificatePassword<SecureString>
Specifies a secure string that contains a password for the management certificate.
Aliases |
none |
Required? |
true |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ManagementCertificatePath<String>
Specifies a file path to the management certificate.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name for the Windows Azure subscription.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PassThru
Returns a Windows Azure subscription 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 |
<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.
- System.String, System.Guid, System.String, System.Security.SecureString, Microsoft.SystemCenter.CloudManager.PowerShell.ACServer
Outputs
The output type is the type of the objects that the cmdlet emits.
- Microsoft.SystemCenter.CloudManager.PowerShell.ACAzureSubscriptionCloud
Examples
Example 1: Add a Windows Azure subscription
The first command creates a secure string for the provided password and stores the secure string in the $MCPassword variable.
The second command adds the Windows Azure subscription with the ID of 1626950e-3af6-4fe8-a7d2-e489c18931a2 using the password stored in $MCPassword and gives it the name AzureSubscription01.
PS C:\> $MCPassword = ConvertTo-SecureString "PassWord!" -AsPlainText -Force
PS C:\> Add-SCACAzureSubscription –Id "1626950e-3af6-4fe8-a7d2-e489c18931a2" –ManagementCertificatePassword $MCPassword –ManagementCertificatePath "C:\CertificatePath" –Name "AzureSubscription01"