2025-04-27 07:49:33 -04:00

207 lines
7.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">
<TITLE>IIsIPSecurity</TITLE>
<SCRIPT LANGUAGE="JavaScript">
<!--
TempString = navigator.appVersion
if (navigator.appName == "Microsoft Internet Explorer"){
// Check to see if browser is Microsoft
if (TempString.indexOf ("4.") >= 0){
// Check to see if it is IE 4
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/coua.css">');
}
else {
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/cocss.css">');
}
}
else if (navigator.appName == "Netscape") {
// Check to see if browser is Netscape
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/coua.css">');
}
else
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/cocss.css">');
//-->
</script>
<SCRIPT LANGUAGE="VBScript">
<!--
Sub Window_OnLoad()
Dim frmContents
On Error Resume Next
If Not Parent Is Nothing Then
Set frmContents = Parent.Contents
If Not frmContents Is Nothing Then
frmContents.Window.TOCSynch_Click
End If
End If
End Sub
//--></SCRIPT><META NAME="DESCRIPTION" CONTENT="Internet Information Services reference information">
<META HTTP-EQUIV="PICS-Label" CONTENT='(PICS-1.1 "<http://www.rsac.org/ratingsv01.html>" l comment "RSACi North America Server" by "inet@microsoft.com <mailto:inet@microsoft.com>" r (n 0 s 0 v 0 l 0))'>
<META NAME="MS.LOCALE" CONTENT="EN-US">
<META NAME="MS-IT-LOC" Content="Internet Information Services">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
<H2><A NAME="_k2_iisipsecurity"></A><SUP></SUP>IIsIPSecurity</H2>
<P>The <B>IIsIPSecurity </B>object is a custom ADSI object that you can use to set access permissions by IP address and domain address.</P>
<P>The <B>IIsIPSecurity</B> Boolean property, <B>GrantByDefault</B>, determines if access by users is granted or denied by default.</P>
<P>If <B>GrantByDefault</B> is set to TRUE, then all IP addresses and Internet domains are granted access, except those you specify to be denied. Use <B>IPDeny</B> and <B>DomainDeny</B> to deny access to specific IP addresses and domains.</P>
<P><span class=le><B>Note</B></span>&nbsp;&nbsp;&nbsp;<B>IPDeny</B> and <B>DomainDeny</B> are only valid if <B>GrantByDefault</B> is set to TRUE.</P>
<P>If <B>GrantByDefault</B> is set to FALSE, then all IP addresses and domains are denied access by default, except those you specify to be granted access. Use <B>IPGrant</B> and <B>DomainGrant </B>to grant access to specific IPs and domains.</P>
<P><span class=le><B>Note</B></span>&nbsp;&nbsp;&nbsp;<B>IPGrant</B> and <B>DomainGrant</B> are only valid if <B>GrantByDefault</B> is set to FALSE.</P>
<H6>ADsPath</H6>
<P>For the server's root virtual directory,
<DL>
<DT>IIS://<I>MachineName</I>/W3SVVC/<I>N</I>/ROOT</DT>
<DT></DT>
</DL>
<P>where <I>MachineName </I>can be any name or "LocalHost."</P>
<P>For a specific virtual directory,
<DL>
<DT>IIS://<I>MachineName</I>/W3SVC/<I>N</I>/ROOT/<I>vdirName</I></DT>
<DT></DT>
</DL>
<P>where <I>MachineName </I>can be any name or "LocalHost."</P>
<H6>Syntax</H6>
<P><I>varReturn </I><B>= </B><I>object</I>.<I>Method</I></P>
<P><I>&nbsp;</I></P>
<H6>Parts</H6>
<DL>
<DT><I>varReturn</I></DT>
<DD>A variable that receives the return value from the method.<BR>
</DD>
<DT><I>object</I></DT>
<DD>A variable that contains the <B>IIsIPSecurity</B> object, usually as a result of a previous <B>GetObject</B> operation.<BR>
</DD>
<DT><I>Method</I></DT>
<DD>The object method chosen.</DD>
</DL>
<H6>Valid Locations</H6>
<TABLE border=0 cellpadding=5 cols=2 frame=box rules=all>
<TR VALIGN="top">
<TD class=blue width=50%><B>Key Type</B></TD>
<TD class=blue width=50%><B>Metabase Path</B></TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore1p5x.htm"><B>IIsWebService</B></A></TD>
<TD width=50%>/LM/W3SVC/ </TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore7zn6.htm"><B>IIsWebServer</B></A></TD>
<TD width=50%>/LM/W3SVC/1 </TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore136t.htm"><B>IIsWebFile</B></A></TD>
<TD width=50%>/LM/W3SVC/1/ROOT/<I>vdirName</I>/<I>text.htm</I> </TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore1jw9.htm"><B>IIsWebDirectory</B></A></TD>
<TD width=50%>/LM/W3SVC/1/ROOT/<I>vdirName</I>/<I>subdirectory</I> </TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore20mq.htm"><B>IIsFtpVirtualDir</B></A></TD>
<TD width=50%>/LM/SMFTPSVC/1/ROOT/<I>vdirName</I></TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore32n9.htm"><B>IIsFtpService</B></A></TD>
<TD width=50%>/LM/SMFTPSVC/ </TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore43si.htm"><B>IIsFtpServer</B></A></TD>
<TD width=50%>/LM/SMFTPSVC/1 </TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore8v5e.htm"><B>IIsWebVirtualDir</B></A></TD>
<TD width=50%>/LM/W3SVC/1/ROOT/Samples </TD>
</TR>
</TABLE><BR>
<H6>IIsIPSecurity Properties</H6>
<TABLE border=0 cellpadding=5 cols=2 frame=box rules=all>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore05ix.htm"><B>IPDeny</B></A></TD>
<TD width=50%>This method accesses an array of IP addresses that are not allowed access to the server.</TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore0hro.htm"><B>IPGrant</B></A></TD>
<TD width=50%>This method accesses an array of IP addresses that are allowed access to the server.</TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore97cp.htm"><B>DomainDeny</B></A></TD>
<TD width=50%>This method accesses an array of domains that are not allowed access to the server.</TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore9qpg.htm"><B>DomainGrant</B></A></TD>
<TD width=50%>This method accesses an array of domains that are allowed access to the server.</TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/aore588k.htm"><B>GrantByDefault</B></A></TD>
<TD width=50%>This Boolean property determines if access is granted by default or not. If <B>GrantByDefault</B> is set to TRUE, then you can use <B>IPDeny</B> and <B>DomainDeny</B> to deny access by specific IP addresses and domains. If <B>GrantByDefault</B> is set to FALSE, then you can use <B>IPGrant</B> and <B>DomainGrant</B> to grant access by specific IP addresses and domains.
<P><span class=le><B>Note</B></span>&nbsp;&nbsp;&nbsp;This property is valid only when used in the context of the <B>IIsIPSecurity</B> object.</P>
</TD>
</TR>
</TABLE><BR>
<H6>Metabase Properties</H6>
<TABLE border=0 cellpadding=5 cols=2 frame=box rules=all>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/adsi57hv.htm">ADSI Object Properties</A></TD>
<TD width=50%>A list of properties valid at multiple objects.</TD>
</TR>
<TR VALIGN="top">
<TD width=50%><A HREF="/iishelp/iis/htm/asp/apro2k1l.htm"><B>IPSecurity</B></A></TD>
<TD width=50%>This property specifies the IP access restrictions for a URL. It can be used to grant or deny access to client browsers based on either their IP address or DNS host name.</TD>
</TR>
</TABLE><BR>
<hr class="iis" size="1">
<p align="center"><em><a href="../../../common/colegal.htm">&copy; 1997-2001 Microsoft Corporation. All rights reserved.</a></em></p>
</BODY>
</HTML>