< Back
Revoke-CHttpUrlPermission
Post
NAME Revoke-CHttpUrlPermission
SYNOPSIS
Revokes all a principal's permission to an HTTP URL.
SYNTAX
Revoke-CHttpUrlPermission [-Url] <String> [-Principal] <String> [<CommonParameters>]
DESCRIPTION
The `Revoke-HttpUrlAclPermission` functions uses the HTTP Server API to revoke user/groups permissions to an HTTP
URL.
[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. This
function removes all permissions to a URL for a specific user or group. If a user or group doesn't have
permission, this function does nothing.
If you want to *change* a user's permissions, use `Grant-CHttpUrlPermission` instead.
This command replaces the `netsh http delete urlacl` command.
`Revoke-HttpUrlAclPermission` was introduced in Carbon 2.1.0.
PARAMETERS
-Url <String>
The URL.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Principal <String>
The user receiving the permission.
Required? true
Position? 2
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
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Revoke-HttpUrlAclPermission -Url 'http://+:4833' -Principal 'FALCON\\HSolo'
Demonstrates how to revoke all a user's permissions to an HTTP URL. In this case Captain Solo will no longer be
able to listen to URL `http://+:4833`.
RELATED LINKS
https://msdn.microsoft.com/en-us/library/aa364510.aspx
Get-CHttpUrlAcl
Grant-CHttpUrlPermission
SYNOPSIS
Revokes all a principal's permission to an HTTP URL.
SYNTAX
Revoke-CHttpUrlPermission [-Url] <String> [-Principal] <String> [<CommonParameters>]
DESCRIPTION
The `Revoke-HttpUrlAclPermission` functions uses the HTTP Server API to revoke user/groups permissions to an HTTP
URL.
[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. This
function removes all permissions to a URL for a specific user or group. If a user or group doesn't have
permission, this function does nothing.
If you want to *change* a user's permissions, use `Grant-CHttpUrlPermission` instead.
This command replaces the `netsh http delete urlacl` command.
`Revoke-HttpUrlAclPermission` was introduced in Carbon 2.1.0.
PARAMETERS
-Url <String>
The URL.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Principal <String>
The user receiving the permission.
Required? true
Position? 2
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
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Revoke-HttpUrlAclPermission -Url 'http://+:4833' -Principal 'FALCON\\HSolo'
Demonstrates how to revoke all a user's permissions to an HTTP URL. In this case Captain Solo will no longer be
able to listen to URL `http://+:4833`.
RELATED LINKS
https://msdn.microsoft.com/en-us/library/aa364510.aspx
Get-CHttpUrlAcl
Grant-CHttpUrlPermission