IISWebAppManagementOnMachineGroup@0 – IIS Web App verwalten v0-Aufgabe

Artikel
2025-03-24

Verwenden Sie diese Aufgabe, um Websites, Web-Apps, virtuelle Verzeichnisse oder Anwendungspools zu erstellen oder zu aktualisieren.

Syntax

# IIS web app manage v0
# Create or update websites, web apps, virtual directories, or application pools.
- task: IISWebAppManagementOnMachineGroup@0
  inputs:
    #EnableIIS: false # boolean. Enable IIS. Default: false.
    IISDeploymentType: 'IISWebsite' # 'IISWebsite' | 'IISWebApplication' | 'IISVirtualDirectory' | 'IISApplicationPool'. Required. Configuration type. Default: IISWebsite.
    ActionIISWebsite: 'CreateOrUpdateWebsite' # 'CreateOrUpdateWebsite' | 'StartWebsite' | 'StopWebsite'. Required when IISDeploymentType = IISWebsite. Action. Default: CreateOrUpdateWebsite.
    #ActionIISApplicationPool: 'CreateOrUpdateAppPool' # 'CreateOrUpdateAppPool' | 'StartAppPool' | 'StopAppPool' | 'RecycleAppPool'. Required when IISDeploymentType = IISApplicationPool. Action. Default: CreateOrUpdateAppPool.
    #StartStopWebsiteName: # string. Required when ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite. Website name. 
    #Protocol: 'http' # 'https' | 'http'. Required when IISDeploymentType = randomDeployment. Protocol. Default: http.
    #IPAddress: 'All Unassigned' # string. Required when IISDeploymentType = randomDeployment. IP address. Default: All Unassigned.
    #Port: '80' # string. Required when IISDeploymentType = randomDeployment. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when IISDeploymentType = randomDeployment. Server Name Indication required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when IISDeploymentType = randomDeployment. Host name. 
    #HostNameWithHttp: # string. Optional. Use when IISDeploymentType = randomDeployment. Host name. 
    #HostNameWithSNI: # string. Required when IISDeploymentType = randomDeployment. Host name. 
    #SSLCertThumbPrint: # string. Required when IISDeploymentType = randomDeployment. SSL certificate thumbprint. 
    #StartStopRecycleAppPoolName: # string. Required when ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool. Application pool name. 
  # IIS Website
    WebsiteName: # string. Required when ActionIISWebsite = CreateOrUpdateWebsite. Website name. 
    WebsitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when ActionIISWebsite = CreateOrUpdateWebsite. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
    WebsitePhysicalPathAuth: 'WebsiteUserPassThrough' # 'WebsiteUserPassThrough' | 'WebsiteWindowsAuth'. Required when ActionIISWebsite = CreateOrUpdateWebsite. Physical path authentication. Default: WebsiteUserPassThrough.
    #WebsiteAuthUserName: # string. Required when WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite. Username. 
    #WebsiteAuthUserPassword: # string. Optional. Use when WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite. Password. 
    #AddBinding: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Add binding. Default: false.
    #CreateOrUpdateAppPoolForWebsite: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Create or update app pool. Default: false.
    #ConfigureAuthenticationForWebsite: false # boolean. Optional. Use when ActionIISWebsite = CreateOrUpdateWebsite. Configure authentication. Default: false.
  # IIS Bindings
    #Bindings: # string. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true. Add bindings. 
  # IIS Application pool
    #AppPoolNameForWebsite: # string. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Name. 
    #DotNetVersionForWebsite: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. .NET version. Default: v4.0.
    #PipeLineModeForWebsite: 'Integrated' # 'Integrated' | 'Classic'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Managed pipeline mode. Default: Integrated.
    #AppPoolIdentityForWebsite: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsernameForWebsite: # string. Required when AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Username. 
    #AppPoolPasswordForWebsite: # string. Optional. Use when AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Password. 
  # IIS Authentication
    #AnonymousAuthenticationForWebsite: false # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Anonymous authentication. Default: false.
    #BasicAuthenticationForWebsite: false # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Basic authentication. Default: false.
    #WindowsAuthenticationForWebsite: true # boolean. Optional. Use when IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Windows authentication. Default: true.
  # IIS Virtual directory
    #ParentWebsiteNameForVD: # string. Required when IISDeploymentType = IISVirtualDirectory. Parent website name. 
    #VirtualPathForVD: # string. Required when IISDeploymentType = IISVirtualDirectory. Virtual path. 
    #PhysicalPathForVD: '%SystemDrive%\inetpub\wwwroot' # string. Required when IISDeploymentType = IISVirtualDirectory. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
    #VDPhysicalPathAuth: 'VDUserPassThrough' # 'VDUserPassThrough' | 'VDWindowsAuth'. Optional. Use when IISDeploymentType = IISVirtualDirectory. Physical path authentication. Default: VDUserPassThrough.
    #VDAuthUserName: # string. Required when VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory. Username. 
    #VDAuthUserPassword: # string. Optional. Use when VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory. Password. 
  # IIS Application
    #ParentWebsiteNameForApplication: # string. Required when IISDeploymentType = IISWebApplication. Parent website name. 
    #VirtualPathForApplication: # string. Required when IISDeploymentType = IISWebApplication. Virtual path. 
    #PhysicalPathForApplication: '%SystemDrive%\inetpub\wwwroot' # string. Required when IISDeploymentType = IISWebApplication. Physical path. Default: %SystemDrive%\inetpub\wwwroot.
    #ApplicationPhysicalPathAuth: 'ApplicationUserPassThrough' # 'ApplicationUserPassThrough' | 'ApplicationWindowsAuth'. Optional. Use when IISDeploymentType = IISWebApplication. Physical path authentication. Default: ApplicationUserPassThrough.
    #ApplicationAuthUserName: # string. Required when ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication. Username. 
    #ApplicationAuthUserPassword: # string. Optional. Use when ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication. Password. 
    #CreateOrUpdateAppPoolForApplication: false # boolean. Optional. Use when IISDeploymentType = IISWebApplication. Create or update app pool. Default: false.
  # IIS Application pool
    #AppPoolNameForApplication: # string. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Name. 
    #DotNetVersionForApplication: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. .NET version. Default: v4.0.
    #PipeLineModeForApplication: 'Integrated' # 'Integrated' | 'Classic'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Managed pipeline mode. Default: Integrated.
    #AppPoolIdentityForApplication: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsernameForApplication: # string. Required when AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Username. 
    #AppPoolPasswordForApplication: # string. Optional. Use when AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Password. 
  # IIS Application pool
    AppPoolName: # string. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Name. 
    DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. .NET version. Default: v4.0.
    PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Managed pipeline mode. Default: Integrated.
    AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when ActionIISApplicationPool = CreateOrUpdateAppPool. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional appcmd.exe commands.

Eingänge

EnableIIS - IIS- aktivieren
boolean. Standardwert: false.

Legen Sie auf true fest, wenn Sie IIS auf dem Computer installieren möchten.

IISDeploymentType - Konfigurationstyp
string. Erforderlich. Zulässige Werte: IISWebsite (IIS-Website), IISWebApplication (IIS-Webanwendung), IISVirtualDirectory (virtuelles IIS-Verzeichnis), IISApplicationPool (IIS-Anwendungspool). Standardwert: IISWebsite.

Gibt den Konfigurationstyp an: Website, Webanwendung, virtuelles Verzeichnis oder Anwendungspool.

ActionIISWebsite - Aktion
string. Erforderlich, wenn IISDeploymentType = IISWebsite. Zulässige Werte: CreateOrUpdateWebsite (Erstellen oder Aktualisieren), StartWebsite (Start), StopWebsite (Beenden). Standardwert: CreateOrUpdateWebsite.

Gibt die entsprechende Aktion an, die Sie auf einer IIS-Website ausführen möchten.

Erstellen oder Aktualisieren eine Website erstellen oder eine vorhandene Website aktualisieren.

Start startet bzw. beendet die Website.

ActionIISApplicationPool - Aktion
string. Erforderlich, wenn IISDeploymentType = IISApplicationPool. Zulässige Werte: CreateOrUpdateAppPool (Erstellen oder Aktualisieren), StartAppPool (Start), StopAppPool (Stopp), RecycleAppPool (Wiederverwenden). Standardwert: CreateOrUpdateAppPool.

Gibt die entsprechende Aktion an, die Sie in einem IIS-Anwendungspool ausführen möchten.

Erstellen oder Aktualisieren erstellt einen Anwendungspool oder aktualisiert einen vorhandenen Anwendungspool.

Starten, Beenden, Wiederverwenden den Anwendungspool bzw. den Anwendungspool beenden oder wiederverwenden.

StartStopWebsiteName - Websitename
string. Erforderlich, wenn ActionIISWebsite = StartWebsite || ActionIISWebsite = StopWebsite.

Gibt den Namen der IIS-Website an.

WebsiteName - Websitename
string. Erforderlich, wenn ActionIISWebsite = CreateOrUpdateWebsite.

Gibt den Namen der IIS-Website an, die erstellt oder aktualisiert werden soll.

WebsitePhysicalPath - physischen Pfad
string. Erforderlich, wenn ActionIISWebsite = CreateOrUpdateWebsite. Standardwert: %SystemDrive%\inetpub\wwwroot.

Gibt den physischen Pfad an, in dem der Websiteinhalt gespeichert wird. Der Inhalt kann sich auf dem lokalen Computer, in einem Remoteverzeichnis oder in einer Netzwerkfreigabe befinden, z. B. C:\Fabrikam oder \\ContentShare\Fabrikam.

WebsitePhysicalPathAuth - physische Pfadauthentifizierung
string. Erforderlich, wenn ActionIISWebsite = CreateOrUpdateWebsite. Zulässige Werte: WebsiteUserPassThrough (Anwendungsbenutzer (Pass-Through)), WebsiteWindowsAuth (Windows-Authentifizierung). Standardwert: WebsiteUserPassThrough.

Gibt den Authentifizierungsmechanismus an, der für den Zugriff auf den physischen Pfad der Website verwendet wird.

WebsiteAuthUserName - Benutzername
string. Erforderlich, wenn WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite.

Gibt den Benutzernamen an, der für den Zugriff auf den physischen Pfad der Website verwendet wird.

WebsiteAuthUserPassword - Kennwort
string. Wahlfrei. Wird verwendet, wenn WebsitePhysicalPathAuth = WebsiteWindowsAuth && ActionIISWebsite = CreateOrUpdateWebsite.

Gibt das Kennwort des Benutzers an, das für den Zugriff auf den physischen Pfad der Website verwendet wird.
Die bewährte Methode besteht darin, eine Variable in der Build- oder Releasepipeline zu erstellen, sie als Secret zu markieren, um sie zu sichern, und stellen Sie sie dann bei Verwendung dieser Eingabe bereit, z. B. $(userCredentials).
Hinweis: Sonderzeichen im Kennwort werden pro Befehlszeilenargumenteinterpretiert.

AddBinding - Hinzufügen von Bindungs-
boolean. Wahlfrei. Wird verwendet, wenn ActionIISWebsite = CreateOrUpdateWebsite. Standardwert: false.

Gibt die Option zum Hinzufügen der Portbindung für die Website an.

Protocol - Protokoll-
string. Erforderlich, wenn IISDeploymentType = randomDeployment. Zulässige Werte: https, http. Standardwert: http.

Gibt entweder HTTP für die Website an, damit eine HTTP-Bindung oder HTTPS für die Website über eine SSL-Bindung (Secure Sockets Layer) verfügt.

IPAddress - IP-Adresse
string. Erforderlich, wenn IISDeploymentType = randomDeployment. Standardwert: All Unassigned.

Gibt eine IP-Adresse an, die Endbenutzer für den Zugriff auf diese Website verwenden können.
Wenn Alle nicht zugewiesenen ausgewählt ist, antwortet die Website auf Anforderungen für alle IP-Adressen am Port und für den Hostnamen. Die Website antwortet nicht auf Anfragen, wenn eine andere Website auf dem Server über eine Bindung an denselben Port verfügt, aber mit einer bestimmten IP-Adresse.

Port - Port
string. Erforderlich, wenn IISDeploymentType = randomDeployment. Standardwert: 80.

Gibt den Port an, an dem der Hypertext Transfer Protocol Stack (HTTP.sys) die Websiteanforderungen überwacht.

ServerNameIndication - Servernamensanzeige erforderlich
boolean. Wahlfrei. Wird verwendet, wenn IISDeploymentType = randomDeployment. Standardwert: false.

Gibt die Option zum Festlegen der Servernamenanzeige (Server Name Indication, SNI) für die Website an.
SNI erweitert die SSL- und TLS-Protokolle, um den Hostnamen anzugeben, mit dem die Clients eine Verbindung herstellen möchten. Sie ermöglicht es mehreren sicheren Websites mit unterschiedlichen Zertifikaten, dieselbe IP-Adresse zu verwenden.

HostNameWithOutSNI - Hostnamen
string. Wahlfrei. Wird verwendet, wenn IISDeploymentType = randomDeployment.

Gibt einen Hostnamen (oder Domänennamen) für die Website an.
Wenn ein Hostname angegeben ist, müssen die Clients den Hostnamen anstelle der IP-Adresse verwenden, um auf die Website zuzugreifen.

HostNameWithHttp - Hostnamen
string. Wahlfrei. Wird verwendet, wenn IISDeploymentType = randomDeployment.

Gibt einen Hostnamen (oder Domänennamen) für die Website an.
Wenn ein Hostname angegeben ist, müssen die Clients den Hostnamen anstelle der IP-Adresse verwenden, um auf die Website zuzugreifen.

HostNameWithSNI - Hostnamen
string. Erforderlich, wenn IISDeploymentType = randomDeployment.

Gibt einen Hostnamen (oder Domänennamen) für die Website an.
Wenn ein Hostname angegeben ist, müssen die Clients den Hostnamen anstelle der IP-Adresse verwenden, um auf die Website zuzugreifen.

SSLCertThumbPrint - SSL-Zertifikatfingerabdruck
string. Erforderlich, wenn IISDeploymentType = randomDeployment.

Gibt den Fingerabdruck des Secure Socket Layer-Zertifikats an, das die Website für die HTTPS-Kommunikation verwendet. Der Fingerabdruck ist eine 40 Zeichen lange hexadezimale Zeichenfolge. Das SSL-Zertifikat sollte bereits auf dem Computer im persönlichen Speicher "Lokaler Computer" installiert sein.

Bindings - Hinzufügen von Bindungen
string. Erforderlich, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && AddBinding = true.

Gibt die Bindungen für die Website an.

Hier ist eine Beispielbindungskonfiguration in YAML:

Bindings: |
  {
      bindings:[
          {
              "protocol":"https",
              "ipAddress":"",
              "hostname":"my.hostname.com",
              "port":"443",
              "sslThumbprint":"",
              "sniFlag":true
          }
      ]
  }

CreateOrUpdateAppPoolForWebsite - Erstellen oder Aktualisieren des App-Pools
boolean. Wahlfrei. Wird verwendet, wenn ActionIISWebsite = CreateOrUpdateWebsite. Standardwert: false.

Gibt die Option zum Erstellen oder Aktualisieren eines Anwendungspools an. Wenn diese Option aktiviert ist, wird die Website im angegebenen Anwendungspool erstellt.

ConfigureAuthenticationForWebsite - Konfigurieren von Authentifizierungs-
boolean. Wahlfrei. Wird verwendet, wenn ActionIISWebsite = CreateOrUpdateWebsite. Standardwert: false.

Gibt die Option zum Konfigurieren der Authentifizierung für die Website an.

AppPoolNameForWebsite - Name
string. Erforderlich, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true.

Gibt den Namen des IIS-Anwendungspools an, der erstellt oder aktualisiert werden soll.

DotNetVersionForWebsite - .NET-Version
string. Erforderlich, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Zulässige Werte: v4.0, v2.0, No Managed Code. Standardwert: v4.0.

Gibt die Version von .NET Framework an, die vom Anwendungspool geladen wird. Wenn die diesem Anwendungspool zugewiesenen Anwendungen keinen verwalteten Code enthalten, wählen Sie in der Liste die Option Kein verwalteter Code aus.

PipeLineModeForWebsite - verwalteten Pipelinemodus
string. Erforderlich, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Zulässige Werte: Integrated, Classic. Standardwert: Integrated.

Gibt den verwalteten Pipelinemodus an, um zu bestimmen, wie IIS Anforderungen für verwaltete Inhalte verarbeitet. Verwenden Sie den klassischen Modus nur, wenn die Anwendungen im Anwendungspool nicht im integrierten Modus ausgeführt werden können.

AppPoolIdentityForWebsite - Identitäts-
string. Erforderlich, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true. Zulässige Werte: ApplicationPoolIdentity (Anwendungspoolidentität), LocalService (lokaler Dienst), LocalSystem (lokales System), NetworkService (Netzwerkdienst), SpecificUser (benutzerdefiniertes Konto). Standardwert: ApplicationPoolIdentity.

Konfiguriert das Konto, unter dem der Arbeitsprozess eines Anwendungspools ausgeführt wird. Gibt eines der vordefinierten Sicherheitskonten an oder konfiguriert ein benutzerdefiniertes Konto.

AppPoolUsernameForWebsite - Benutzername
string. Erforderlich, wenn AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true.

Gibt den Benutzernamen des benutzerdefinierten Kontos an, das Sie verwenden möchten.

AppPoolPasswordForWebsite - Kennwort
string. Wahlfrei. Wird verwendet, wenn AppPoolIdentityForWebsite = SpecificUser && IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && CreateOrUpdateAppPoolForWebsite = true.

Gibt das Kennwort für das benutzerdefinierte Konto an.
Die bewährte Methode besteht darin, eine Variable in der Build- oder Releasepipeline zu erstellen, sie als Secret zu markieren, um sie zu sichern, und stellen Sie sie dann bei Verwendung dieser Eingabe bereit, z. B. $(userCredentials).
Hinweis: Sonderzeichen im Kennwort werden pro Befehlszeilenargumenteinterpretiert.

AnonymousAuthenticationForWebsite - anonyme Authentifizierung
boolean. Wahlfrei. Wird verwendet, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Standardwert: false.

Gibt die Option zum Aktivieren der anonymen Authentifizierung für eine Website an.

BasicAuthenticationForWebsite - Standardauthentifizierung
boolean. Wahlfrei. Wird verwendet, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Standardwert: false.

Gibt die Option zum Aktivieren der Standardauthentifizierung für eine Website an.

WindowsAuthenticationForWebsite - Windows-Authentifizierung
boolean. Wahlfrei. Wird verwendet, wenn IISDeploymentType = IISWebsite && ActionIISWebsite = CreateOrUpdateWebsite && ConfigureAuthenticationForWebsite = true. Standardwert: true.

Gibt die Option zum Aktivieren der Windows-Authentifizierung für eine Website an.

ParentWebsiteNameForVD - Namen der übergeordneten Website
string. Erforderlich, wenn IISDeploymentType = IISVirtualDirectory.

Gibt den Namen der übergeordneten Website des virtuellen Verzeichnisses an.

VirtualPathForVD - virtueller Pfad
string. Erforderlich, wenn IISDeploymentType = IISVirtualDirectory.

Gibt den virtuellen Pfad des virtuellen Verzeichnisses an.

Wenn Sie beispielsweise ein virtuelles Verzeichnis Site/Application/VDirerstellen möchten, geben Sie /Application/Vdirein. Die übergeordnete Website und Anwendung sollte bereits vorhanden sein.

PhysicalPathForVD - physischen Pfad
string. Erforderlich, wenn IISDeploymentType = IISVirtualDirectory. Standardwert: %SystemDrive%\inetpub\wwwroot.

Gibt den physischen Pfad an, in dem der Inhalt des virtuellen Verzeichnisses gespeichert ist. Der Inhalt kann sich auf dem lokalen Computer, in einem Remoteverzeichnis oder in einer Netzwerkfreigabe befinden, z. B. C:\Fabrikam oder \\ContentShare\Fabrikam.

VDPhysicalPathAuth - physische Pfadauthentifizierung
string. Wahlfrei. Wird verwendet, wenn IISDeploymentType = IISVirtualDirectory. Zulässige Werte: VDUserPassThrough (Anwendungsbenutzer (Pass-Through)), VDWindowsAuth (Windows-Authentifizierung). Standardwert: VDUserPassThrough.

Gibt den Authentifizierungsmechanismus an, der für den Zugriff auf den physischen Pfad des virtuellen Verzeichnisses verwendet wird.

VDAuthUserName - Benutzername
string. Erforderlich, wenn VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory.

Gibt den Benutzernamen an, der für den Zugriff auf den physischen Pfad des virtuellen Verzeichnisses verwendet wird.

VDAuthUserPassword - Kennwort
string. Wahlfrei. Wird verwendet, wenn VDPhysicalPathAuth = VDWindowsAuth && IISDeploymentType = IISVirtualDirectory.

Gibt das Kennwort des Benutzers an, das für den Zugriff auf den physischen Pfad des virtuellen Verzeichnisses verwendet wird.
Die bewährte Methode besteht darin, eine Variable in der Build- oder Releasepipeline zu erstellen, sie als Secret zu markieren, um sie zu sichern, und stellen Sie sie dann bei Verwendung dieser Eingabe bereit, z. B. $(userCredentials).
Hinweis: Sonderzeichen im Kennwort werden pro Befehlszeilenargumenteinterpretiert.

ParentWebsiteNameForApplication - Namen der übergeordneten Website
string. Erforderlich, wenn IISDeploymentType = IISWebApplication.

Gibt den Namen der übergeordneten Website an, unter der die Anwendung erstellt oder aktualisiert wird.

VirtualPathForApplication - virtueller Pfad
string. Erforderlich, wenn IISDeploymentType = IISWebApplication.

Gibt den virtuellen Pfad der Anwendung an.

Wenn Sie beispielsweise eine Anwendung Site/Applicationerstellen möchten, geben Sie /Applicationein. Die übergeordnete Website sollte bereits vorhanden sein.

PhysicalPathForApplication - physischen Pfad
string. Erforderlich, wenn IISDeploymentType = IISWebApplication. Standardwert: %SystemDrive%\inetpub\wwwroot.

Gibt den physischen Pfad an, in dem der Inhalt der Anwendung gespeichert wird. Der Inhalt kann sich auf dem lokalen Computer, in einem Remoteverzeichnis oder in einer Netzwerkfreigabe befinden, z. B. C:\Fabrikam oder \\ContentShare\Fabrikam.

ApplicationPhysicalPathAuth - physische Pfadauthentifizierung
string. Wahlfrei. Wird verwendet, wenn IISDeploymentType = IISWebApplication. Zulässige Werte: ApplicationUserPassThrough (Anwendungsbenutzer (Pass-Through)), ApplicationWindowsAuth (Windows-Authentifizierung). Standardwert: ApplicationUserPassThrough.

Gibt den Authentifizierungsmechanismus an, der für den Zugriff auf den physischen Pfad der Anwendung verwendet wird.

ApplicationAuthUserName - Benutzername
string. Erforderlich, wenn ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication.

Gibt den Benutzernamen an, der für den Zugriff auf den physischen Pfad der Anwendung verwendet wird.

ApplicationAuthUserPassword - Kennwort
string. Wahlfrei. Wird verwendet, wenn ApplicationPhysicalPathAuth = ApplicationWindowsAuth && IISDeploymentType = IISWebApplication.

Gibt das Kennwort des Benutzers an, das für den Zugriff auf den physischen Pfad der Anwendung verwendet wird.
Die bewährte Methode besteht darin, eine Variable in der Build- oder Releasepipeline zu erstellen, sie als Secret zu markieren, um sie zu sichern, und stellen Sie sie dann bei Verwendung dieser Eingabe bereit, z. B. $(userCredentials).
Hinweis: Sonderzeichen im Kennwort werden pro Befehlszeilenargumenteinterpretiert.

CreateOrUpdateAppPoolForApplication - Erstellen oder Aktualisieren des App-Pools
boolean. Wahlfrei. Wird verwendet, wenn IISDeploymentType = IISWebApplication. Standardwert: false.

Gibt die Option zum Erstellen oder Aktualisieren eines Anwendungspools an. Wenn diese Option aktiviert ist, wird die Anwendung im angegebenen Anwendungspool erstellt.

AppPoolNameForApplication - Name
string. Erforderlich, wenn IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true.

Gibt den Namen des IIS-Anwendungspools an, der erstellt oder aktualisiert werden soll.

DotNetVersionForApplication - .NET-Version
string. Erforderlich, wenn IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Zulässige Werte: v4.0, v2.0, No Managed Code. Standardwert: v4.0.

PipeLineModeForApplication - verwalteten Pipelinemodus
string. Erforderlich, wenn IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Zulässige Werte: Integrated, Classic. Standardwert: Integrated.

AppPoolIdentityForApplication - Identitäts-
string. Erforderlich, wenn IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true. Zulässige Werte: ApplicationPoolIdentity (Anwendungspoolidentität), LocalService (lokaler Dienst), LocalSystem (lokales System), NetworkService (Netzwerkdienst), SpecificUser (benutzerdefiniertes Konto). Standardwert: ApplicationPoolIdentity.

Konfiguriert das Konto, unter dem der Arbeitsprozess eines Anwendungspools ausgeführt wird. Gibt eines der vordefinierten Sicherheitskonten an oder konfiguriert ein benutzerdefiniertes Konto.

AppPoolUsernameForApplication - Benutzername
string. Erforderlich, wenn AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true.

Gibt den Benutzernamen des benutzerdefinierten Kontos an, das Sie verwenden möchten.

AppPoolPasswordForApplication - Kennwort
string. Wahlfrei. Wird verwendet, wenn AppPoolIdentityForApplication = SpecificUser && IISDeploymentType = IISWebApplication && CreateOrUpdateAppPoolForApplication = true.

AppPoolName - Name
string. Erforderlich, wenn ActionIISApplicationPool = CreateOrUpdateAppPool.

Gibt den Namen des IIS-Anwendungspools an, der erstellt oder aktualisiert werden soll.

DotNetVersion - .NET-Version
string. Erforderlich, wenn ActionIISApplicationPool = CreateOrUpdateAppPool. Zulässige Werte: v4.0, v2.0, No Managed Code. Standardwert: v4.0.

PipeLineMode - verwalteten Pipelinemodus
string. Erforderlich, wenn ActionIISApplicationPool = CreateOrUpdateAppPool. Zulässige Werte: Integrated, Classic. Standardwert: Integrated.

AppPoolIdentity - Identitäts-
string. Erforderlich, wenn ActionIISApplicationPool = CreateOrUpdateAppPool. Zulässige Werte: ApplicationPoolIdentity (Anwendungspoolidentität), LocalService (lokaler Dienst), LocalSystem (lokales System), NetworkService (Netzwerkdienst), SpecificUser (benutzerdefiniertes Konto). Standardwert: ApplicationPoolIdentity.

Konfiguriert das Konto, unter dem der Arbeitsprozess eines Anwendungspools ausgeführt wird. Gibt eines der vordefinierten Sicherheitskonten an oder konfiguriert ein benutzerdefiniertes Konto.

AppPoolUsername - Benutzername
string. Erforderlich, wenn AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool.

Gibt den Benutzernamen des benutzerdefinierten Kontos an, das Sie verwenden möchten.

AppPoolPassword - Kennwort
string. Wahlfrei. Wird verwendet, wenn AppPoolIdentity = SpecificUser && ActionIISApplicationPool = CreateOrUpdateAppPool.

StartStopRecycleAppPoolName - Anwendungspoolname
string. Erforderlich, wenn ActionIISApplicationPool = StartAppPool || ActionIISApplicationPool = StopAppPool || ActionIISApplicationPool = RecycleAppPool.

Gibt den Namen des IIS-Anwendungspools an.

AppCmdCommands - Zusätzliche appcmd.exe Befehle
string.

Gibt zusätzliche AppCmd.exe Befehle an. Verwenden Sie für mehrere Befehle ein Zeilentrennzeichen.
Beispiel:
list apppools
list sites
recycle apppool /apppool.name:ExampleAppPoolName

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine Website, Web-App, ein virtuelles Verzeichnis oder einen Anwendungspool zu erstellen oder zu aktualisieren.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	Klassische Version
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.111.0 oder höher
Vorgangskategorie	Einsetzen

Freigeben über

IISWebAppManagementOnMachineGroup@0 – IIS Web App verwalten v0-Aufgabe

Syntax

Eingänge

Aufgabensteuerungsoptionen

Ausgabevariablen

Bemerkungen

Anforderungen

Feedback

Zusätzliche Ressourcen