Suspend-SCACServiceDeployment
Applies To: System Center 2012 R2 App Controller
Suspend-SCACServiceDeployment
Suspends the specified service deployment.
Syntax
Parameter Set: Default
Suspend-SCACServiceDeployment [-ServiceDeployment] <ACServiceDeployment> [[-RunAsynchronously]] [ <CommonParameters>]
Detailed Description
The Suspend-SCACServiceDeployment cmdlet suspends the specified service deployment. To resume a service deployment, use the Resume-SCACServiceDeployment cmdlet.
Parameters
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
Aliases |
none |
Required? |
false |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ServiceDeployment<ACServiceDeployment>
Specifies a service deployment object. To get a service deployment object, use the Get-SCACAzureServiceDeployment cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
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.
- Microsoft.SystemCenter.CloudManager.PowerShell.ACServiceDeployment, System.Management.Automation.SwitchParameter
Outputs
The output type is the type of the objects that the cmdlet emits.
- Microsoft.SystemCenter.CloudManager.PowerShell.ACServiceDeployment
Examples
Example 1: Suspend a service deployment
The first command gets the Windows Azure subscription object named AzureSubscription01 and stores the object in the $Subscription variable.
The second command gets all service deployment objects for the subscription stored in $Subscription and stores the service deployment objects in the $SvcDeployment variable.
The last command suspends the first service deployment stored in $SvcDeployment, and runs the command asynchronously so that control returns to the command shell immediately, before the command stops running.
PS C:\> $Subscription = Get-SCACAzureSubscription –Name “AzureSubscription01”
PS C:\> $SvcDeployment = Get-SCACAzureServiceDeployment –Subscription $Subscription
PS C:\> Suspend-SCACServiceDeployment -ServiceDeployment $SvcDeployment[0] -RunAsynchronously