Configure Service Metadata Using AppFabric Cmdlets

You can use the following cmdlets to set, get, or clear service-metadata configuration settings.

Cmdlet	Description
Get-ASAppServiceMetadata	Gets the values of the httpGetEnabled and httpGetUrl attributes of the serviceMetadata element in the configuration file associated with the specified scope.
Set-ASAppServiceMetadata	Sets the values of the httpGetEnabled attribute of the serviceMetadata element in the configuration file associated with the specified scope. If the serviceMetadata element does not exist, the cmdlet adds the element and sets the values of the httpGetEnabled attribute on the element.
Clear-ASAppServiceMetadata	Removes the serviceMetadata element from the configuration file associated with the specified scope.

Syntax options for the Get-ASAppServiceMetadata cmdlet

// to get service-metadata settings at the root level
Get-ASAppServiceMetadata –root 

// Web site level
Get-ASAppServiceMetadata -SiteName <String>

Example: 
Get-ASAppServiceMetadata –SiteName “Default Web Site” 

// At the level pointed by the virtual path
Get-ASAppServiceMetadata -SiteName <String> -VirtualPath <string>

Examples: 
Get-ASAppServiceMetadata –SiteName “Default Web Site” –VirtualPath /SampleApp
Get-ASAppServiceMetadata –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx”

// At the level pointed by the URI
Get-ASAppServiceMetadata –Uri <Uri> 

Examples: 
Get-ASAppServiceMetadata –Uri https://localhost
Get-ASAppServiceMetadata –Uri https://localhost/SampleService
Get-ASAppServiceMetadata –Uri https://localhost/SampleService/SampleService.xamlx

// At the application level specified by using the ApplicationObject
Get-ASAppServiceMetadata –ApplicationObject <ApplicationInfo> 

Example: 
Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASAppServiceMetadata 

// At the service level specified by using the ServiceInfo object
Get-ASAppServiceMetadata –ServiceObject <ServiceInfo>

Example: 
Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASAppServiceMetadata

Syntax options for the Set-ASAppServiceMetadata cmdlet

// to set service-metadata settings at the root level
Set-ASAppServiceMetadata –root –httpGetEnabled <Boolean>

Example:
Set-ASAppServiceMetadata –root –httpGetEnabled 1

// Web site level
Set-ASAppServiceMetadata -SiteName <String> –httpGetEnabled 1

Example: 
Set-ASAppServiceMetadata –SiteName “Default Web Site” –httpGetEnabled 1

// At the level pointed by the virtual path
Set-ASAppServiceMetadata -SiteName <String> -VirtualPath <string> –httpGetEnabled <Boolean>

Examples: 
Set-ASAppServiceMetadata –SiteName “Default Web Site” –VirtualPath /SampleApp –httpGetEnabled 1
Set-ASAppServiceMetadata –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” –httpGetEnabled 1

// At the level pointed by the URI
Set-ASAppServiceMetadata –Uri <Uri> –httpGetEnabled <Boolean>

Examples: 
Set-ASAppServiceMetadata –Uri https://localhost –httpGetEnabled 1
Set-ASAppServiceMetadata –Uri https://localhost/SampleService -httpGetEnabled 1
Set-ASAppServiceMetadata –Uri https://localhost/SampleService/SampleService.xamlx -httpGetEnabled 1

// At the application level specified by using the ApplicationObject
Set-ASAppServiceMetadata –ApplicationObject <ApplicationInfo> –httpGetEnabled <Boolean>

Example: 
Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Set-ASAppServiceMetadata –httpGetEnabled 1

// At the service level specified by using the ServiceInfo object
Set-ASAppServiceMetadata –ServiceObject <ServiceInfo> –httpGetEnabled <Boolean>

Example: 
Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Set-ASAppServiceMetadata –httpGetEnabled 1

Parameters specific to the Set-ASAppServiceMetadata cmdlet

Parameter	Description
httpGetEnabled	Specifies whether the metadata of service can be accessed over HTTP protocol.

Syntax options for the Clear-ASAppServiceMetadata cmdlet

// to clear service-metadata settings at the root level
Clear-ASAppServiceMetadata –root 

// Web site level
Clear-ASAppServiceMetadata -SiteName <String>

Example: 
Clear-ASAppServiceMetadata –SiteName “Default Web Site” 

// At the level pointed by the virtual path
Clear-ASAppServiceMetadata -SiteName <String> -VirtualPath <string>

Examples: 
Clear-ASAppServiceMetadata –SiteName “Default Web Site” –VirtualPath /SampleApp 
Clear-ASAppServiceMetadata –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” 

// At the level pointed by the URI
Clear-ASAppServiceMetadata –Uri <Uri> 

Examples: 
Clear-ASAppServiceMetadata –Uri https://localhost
Clear-ASAppServiceMetadata –Uri https://localhost/SampleService
Clear-ASAppServiceMetadata –Uri https://localhost/SampleService/SampleService.xamlx

// At the application level specified by using the ApplicationObject
Clear-ASAppServiceMetadata –ApplicationObject <ApplicationInfo> 

Example: 
Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Clear-ASAppServiceMetadata 

// At the service level specified by using the ServiceInfo object
Clear-ASAppServiceMetadata –ServiceObject <ServiceInfo>

Example: 
Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Clear-ASAppServiceMetadata

  2012-09-12