Httpcfg Examples

Article
10/08/2009

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Httpcfg Examples

httpcfg ssl

httpcfg urlacl

httpcfg ssl

This group of examples shows how to add, show, and delete a certificate in the SSL store.

Adding an SSL Certificate to the Store

In the following example, the user types the set ssl command, using the /i, /h, and /g parameters to specify the IP address, Thumbprint hash, and GUID, respectively, for the certificate being added.

httpcfg set ssl /i 10.0.0.1:80 /h 2c8bfddf59a4a51a2a5b6186c22473108295624d /g "{2bb50d9c-7f6a-4d6f-873d-5aee7fb43290}"

After running the command, Httpcfg displays the following text on the screen to confirm the command completed without an error (error code of 0).

HttpSetServiceConfiguration completed with 0.

Viewing Certificates in the SSL Store.

In this example, the user first types the query ssl command with the /i parameter, specifying an IP address in order to view the meta-information for a particular certificate. Following that, the user types query ssl without the /i paremeter, to view all certificates in the store.

httpcfg query ssl

     IP                      : 10.0.0.13:80
    Hash                    : 2c8bfddf59a4a51a2a5b6186c22473108295624d
    Guid                    : {2bb50d9c-7f6a-4d6f-873d-5aee7fb43290}
    CertStoreName           : (null)
    CertCheckMode           : 0
    RevocationFreshnessTime : 0
    UrlRetrievalTimeout     : 0
    SslCtlIdentifier        : (null)
    SslCtlStoreName         : (null)
    Flags                   : 0
------------------------------------------------------------------------------
    IP                      : 10.0.0.1:80
    Hash                    : 2c8bfddf59a4a51a2a5b6186c22473108295624d
    Guid                    : {2bb50d9c-7f6a-4d6f-873d-5aee7fb43290}
    CertStoreName           : (null)
    CertCheckMode           : 0
    RevocationFreshnessTime : 0
    UrlRetrievalTimeout     : 0
    SslCtlIdentifier        : (null)
    SslCtlStoreName         : (null)
    Flags                   : 0
------------------------------------------------------------------------------

Deleting a Certificate from the SSL Store.

In this example, the user types delete ssl with the required /i parameter to delete the associated certificate record from the SSL store.

httpcfg delete ssl /i 10.0.0.1:80

Httpcgf then displays the following text to the screen, verifying that the command completed successfully (error code of 0).

HttpDeleteServiceConfiguration completed with 0.

httpcfg urlacl

This group of examples show how to add, remove, and view URL ACL combinations in the urlacl store.

Adding a URL ACL combination to the urlacl store

httpcfg set urlacl /u https://woodgrovebank.com:443/ /a "O:DAG:DAD:(A;;GRGX;;;DA)(A;;GA;;;BA)"

HttpSetServiceConfiguration completed with 0.

Viewing all of the URLs that have been assigned an ACL.

httpcfg query urlacl

    URL : https://woodgrovebank.com:443/
    ACL : O:DAG:DAD:(A;;GXGR;;;DA)(A;;GA;;;BA)
------------------------------------------------------------------------------
    URL : https://woodgrovebank.com:80/
    ACL : O:DAG:DAD:(A;;CCDC;;;SY)(A;;CCDC;;;DA)(OA;;CCDC;bf967aba-0de6-11d0-a285-00aa003049e2;;AO)(OA;;CCDC;bf967a9c-0d
e6-11d0-a285-00aa003049e2;;AO)(OA;;CCDC;6da8a4ff-0e52-11d0-a286-00aa003049e2;;AO)(OA;;CCDC;bf967aa8-0de6-11d0-a285-00aa0
03049e2;;PO)(A;;;;;AU)S:(AU;SAFA;CCDCSWWPSDWDWO;;;WD)
------------------------------------------------------------------------------

Deleting a URL ACL combination from the urlacl store.

httpcfg delete urlacl /u https://woodgrovebank.com:80/

HttpDeleteServiceConfiguration completed with 0.

httpcfg iplisten

This group of examples show how to add, delete, and list IP address in the iplisten store.

Adding an IP address to the iplisten store.

httpcfg set iplisten -i 10.0.0.1:80

HttpSetServiceConfiguration completed with 0.

Viewing all off the IP addresses that the HTTP API is listening on.

httpcfg query iplisten

    IP                      : 10.0.0.1:80
------------------------------------------------------------------------------
    IP                      : 10.0.0.13:80
------------------------------------------------------------------------------

Shows the result of deleting a record from the iplisten store.

httpcfg delete iplisten -i 10.0.0.1:80

HttpDeleteServiceConfiguration completed with 0.

Httpcfg Examples