Remove-ASAppServiceInstance

Remove-ASAppServiceInstance

Remove one or more service instances from the instance store.

Syntax

Parameter Set: ByName
Remove-ASAppServiceInstance -ServiceInstanceInfo <ServiceInstanceInfo> [-Force] [ <CommonParameters>]

Detailed Description

This cmdlet deletes the specified service instances from the instance store. It is intended to remove completed instances from the instance store. Removing a running instance will cause that instance to fail.

The instances of services that are undeployed from all servers in a web farm may still remain in the persistence store and may show up in the results of persistence store queries. Also, if a server is pulled off from the network, instances may be left as “zombies” in the persistence store.

This cmdlet provides the ability to clean up such stale instances. Since this is a destructive operation, explicit user confirmation is mandatory unless the -force flag is specified.

Parameters

-Force

Use this parameter to force removal of information from the persistence database without requiring confirmation from the user.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?

-ServiceInstanceInfo<ServiceInstanceInfo>

Specify the ServiceInstance object that corresponds to the service instance whose information needs to be purged from the persistence database. This parameter is used in piping scenarios.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?

<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.

• None.

Outputs

The output type is the type of the objects that the cmdlet emits.

• None.

Examples

EXAMPLE 1

This command removes stale instances of a specific service type.

Get-ASAppServiceInstance –ServiceType “Contoso#PurchaseOrderService” | Remove-ASAppServiceInstance

EXAMPLE 2

This command forcefully removes all instances of services of a specific application from a persistence store.

Get-ASAppService –SiteName “My Web Site” –VirtualPath “/App1” | Get-ASAppServiceInstance | Remove-ASAppServiceInstance -force