< Back
Get-CHttpUrlAcl
Post
NAME Get-CHttpUrlAcl
SYNOPSIS
Gets HTTP URL security information.
SYNTAX
Get-CHttpUrlAcl [<CommonParameters>]
Get-CHttpUrlAcl [-Url <String>] [<CommonParameters>]
Get-CHttpUrlAcl [-LiteralUrl <String>] [<CommonParameters>]
DESCRIPTION
The `Get-CHttpUrlAcl` functions uses the HTTP Server API to get HTTP URL ACL information. With no parameters, it
returns `Carbon.Security.HttpUrlSecurity` objects for all the HTTP URL ACLs. To get a specific HTTP URL ACL, use
the `Name` parameter (wildcards supported).
[The HTTP Server API](https://msdn.microsoft.com/en-us/library/aa364510.aspx)
> enables applications to communicate over HTTP without using Microsoft Internet Information Server (IIS).
Applications can register to receive HTTP requests for particular URLs, receive HTTP requests, and send HTTP
responses.
An application that uses the HTTP Server API must register all URLs it listens (i.e. binds, registers) to. When
registering, the user who will listen to the URL must also be provided. Typically, this is done with the `netsh
http (show|add|remove) urlacl` command(s). This function replaces the `netsh http show urlacl` command.
`Get-CHttpUrlAcl` was introduced in Carbon 2.1.0.
PARAMETERS
-Url <String>
The URL whose security information to get. Wildcards supported.
Make sure your URL ends with a forward slash.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-LiteralUrl <String>
The literal URL whose security information to get.
Make sure your URL ends with a forward slash.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Carbon.Security.HttpUrlSecurity.
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-CHttpUrlAcl
Demonstrates how to get security information for all HTTP URLs configured on the current computer.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-CHttpUrlAcl -Url 'http://+:8594/'
Demonstrates how to get security information for a specific HTTP URL.
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Get-CHttpUrlAcl -Url 'htt://*:8599/'
Demonstrates how to use wildcards to find security information. In this case, all URLs that use port 8599 will be
returned.
When using wildcards, it is important that your URL end with a slash! The HTTP Server API adds a forward slash to
the end of all its URLs.
-------------------------- EXAMPLE 4 --------------------------
PS C:\\>Get-CHttpUrlAcl -LiteralUrl 'http://*:8599/'
Demonstrates how to use a literal URL to find security information. Will only return the ACL for the URL
`http://*:8599/`.
RELATED LINKS
https://msdn.microsoft.com/en-us/library/aa364510.aspx
Grant-CHttpUrlPermission
Revoke-CHttpUrlPermission
Name : Get-IisApplication
Category : Alias
Synopsis : Get-CIisApplication
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISApplicationPool; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISApplicationPool
ModuleName : CPolydorou.IIS
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISApplicationPool
Category : Function
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISApplicationPoolWorkerProcesses; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISApplicationPoolWorkerProcesses
ModuleName : CPolydorou.IIS
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISApplicationPoolWorkerProcesses
Category : Function
Component :
Role :
Functionality :
Name : Get-IisAppPool
Category : Alias
Synopsis : Get-CIisAppPool
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISAppPoolIdentity; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISAppPoolIdentity
ModuleName : TelligentInstall
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISAppPoolIdentity
Category : Function
Component :
Role :
Functionality :
Name : Get-IisConfigurationSection
Category : Alias
Synopsis : Get-CIisConfigurationSection
Component :
Role :
Functionality :
Name : Get-IisHttpHeader
Category : Alias
Synopsis : Get-CIisHttpHeader
Component :
Role :
Functionality :
Name : Get-IisHttpRedirect
Category : Alias
Synopsis : Get-CIisHttpRedirect
Component :
Role :
Functionality :
Name : Get-IisMimeMap
Category : Alias
Synopsis : Get-CIisMimeMap
Component :
Role :
Functionality :
Name : Get-IisSecurityAuthentication
Category : Alias
Synopsis : Get-CIisSecurityAuthentication
Component :
Role :
Functionality :
Name : Get-IisVersion
Category : Alias
Synopsis : Get-CIisVersion
Component :
Role :
Functionality :
Name : Get-IisWebsite
Category : Alias
Synopsis : Get-CIisWebsite
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISWebSitePath; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISWebSitePath
ModuleName : DosInstallUtilities
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISWebSitePath
Category : Function
Component :
Role :
Functionality :
SYNOPSIS
Gets HTTP URL security information.
SYNTAX
Get-CHttpUrlAcl [<CommonParameters>]
Get-CHttpUrlAcl [-Url <String>] [<CommonParameters>]
Get-CHttpUrlAcl [-LiteralUrl <String>] [<CommonParameters>]
DESCRIPTION
The `Get-CHttpUrlAcl` functions uses the HTTP Server API to get HTTP URL ACL information. With no parameters, it
returns `Carbon.Security.HttpUrlSecurity` objects for all the HTTP URL ACLs. To get a specific HTTP URL ACL, use
the `Name` parameter (wildcards supported).
[The HTTP Server API](https://msdn.microsoft.com/en-us/library/aa364510.aspx)
> enables applications to communicate over HTTP without using Microsoft Internet Information Server (IIS).
Applications can register to receive HTTP requests for particular URLs, receive HTTP requests, and send HTTP
responses.
An application that uses the HTTP Server API must register all URLs it listens (i.e. binds, registers) to. When
registering, the user who will listen to the URL must also be provided. Typically, this is done with the `netsh
http (show|add|remove) urlacl` command(s). This function replaces the `netsh http show urlacl` command.
`Get-CHttpUrlAcl` was introduced in Carbon 2.1.0.
PARAMETERS
-Url <String>
The URL whose security information to get. Wildcards supported.
Make sure your URL ends with a forward slash.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-LiteralUrl <String>
The literal URL whose security information to get.
Make sure your URL ends with a forward slash.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Carbon.Security.HttpUrlSecurity.
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-CHttpUrlAcl
Demonstrates how to get security information for all HTTP URLs configured on the current computer.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-CHttpUrlAcl -Url 'http://+:8594/'
Demonstrates how to get security information for a specific HTTP URL.
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Get-CHttpUrlAcl -Url 'htt://*:8599/'
Demonstrates how to use wildcards to find security information. In this case, all URLs that use port 8599 will be
returned.
When using wildcards, it is important that your URL end with a slash! The HTTP Server API adds a forward slash to
the end of all its URLs.
-------------------------- EXAMPLE 4 --------------------------
PS C:\\>Get-CHttpUrlAcl -LiteralUrl 'http://*:8599/'
Demonstrates how to use a literal URL to find security information. Will only return the ACL for the URL
`http://*:8599/`.
RELATED LINKS
https://msdn.microsoft.com/en-us/library/aa364510.aspx
Grant-CHttpUrlPermission
Revoke-CHttpUrlPermission
Name : Get-IisApplication
Category : Alias
Synopsis : Get-CIisApplication
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISApplicationPool; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISApplicationPool
ModuleName : CPolydorou.IIS
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISApplicationPool
Category : Function
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISApplicationPoolWorkerProcesses; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISApplicationPoolWorkerProcesses
ModuleName : CPolydorou.IIS
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISApplicationPoolWorkerProcesses
Category : Function
Component :
Role :
Functionality :
Name : Get-IisAppPool
Category : Alias
Synopsis : Get-CIisAppPool
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISAppPoolIdentity; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISAppPoolIdentity
ModuleName : TelligentInstall
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISAppPoolIdentity
Category : Function
Component :
Role :
Functionality :
Name : Get-IisConfigurationSection
Category : Alias
Synopsis : Get-CIisConfigurationSection
Component :
Role :
Functionality :
Name : Get-IisHttpHeader
Category : Alias
Synopsis : Get-CIisHttpHeader
Component :
Role :
Functionality :
Name : Get-IisHttpRedirect
Category : Alias
Synopsis : Get-CIisHttpRedirect
Component :
Role :
Functionality :
Name : Get-IisMimeMap
Category : Alias
Synopsis : Get-CIisMimeMap
Component :
Role :
Functionality :
Name : Get-IisSecurityAuthentication
Category : Alias
Synopsis : Get-CIisSecurityAuthentication
Component :
Role :
Functionality :
Name : Get-IisVersion
Category : Alias
Synopsis : Get-CIisVersion
Component :
Role :
Functionality :
Name : Get-IisWebsite
Category : Alias
Synopsis : Get-CIisWebsite
Component :
Role :
Functionality :
CommonParameters : False
WorkflowCommonParameters : False
details : @{name=Get-IISWebSitePath; noun=; verb=}
Syntax : @{syntaxItem=System.Object[]}
parameters : @{parameter=System.Object[]}
inputTypes : @{inputType=}
returnValues : @{returnValue=}
aliases : None
remarks : None
alertSet :
description :
examples :
Synopsis :
Get-IISWebSitePath
ModuleName : DosInstallUtilities
nonTerminatingErrors :
xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10
xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10
xmlns:maml : http://schemas.microsoft.com/maml/2004/10
Name : Get-IISWebSitePath
Category : Function
Component :
Role :
Functionality :