In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.
Optional. Wenn true festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird, und wartet nicht auf den Abschluss des Skripts.
bool
errorBlobManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die Zugriff auf errorBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt bei systemseitig zugewiesener Identität. Stellen Sie sicher, dass die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged
Gibt das Azure-Speicherblob an, in das der Skriptfehlerstream hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs- oder Schreibzugriff oder mit verwalteter Identität, um dem virtuellen Computer Zugriff auf das Blob zu gewähren. Weitere Informationen finden Sie unter errorBlobManagedIdentity-Parameter.
Zeichenfolge
outputBlobManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt bei systemseitig zugewiesener Identität. Stellen Sie sicher, dass die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged
Gibt das Azure Storage-Blob an, in das der Skriptausgabestream hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs- oder Schreibzugriff oder mit verwalteter Identität, um dem virtuellen Computer Zugriff auf das Blob zu gewähren. Weitere Informationen finden Sie unter outputBlobManagedIdentity-Parameter.
Das Timeout in Sekunden, um den Befehl ausführen zu können.
INT
treatFailureAsDeploymentFailure
Optional. Wenn auf true festgelegt ist, tritt bei jedem Fehler im Skript ein Fehler bei der Bereitstellung auf, und ProvisioningState wird als Fehler markiert. Wenn dieser Wert auf false festgelegt ist, gibt ProvisioningState nur an, ob der Ausführungsbefehl von der Erweiterungsplattform ausgeführt wurde oder nicht. Dies gibt nicht an, ob ein Skriptfehler bei Skriptfehlern aufgetreten ist. Siehe instance Ansicht des Ausführungsbefehls bei Skriptfehlern, um executionMessage, output, error zu sehen:https://aka.ms/runcommandmanaged#get-execution-status-and-results
bool
RunCommandManagedIdentity
Name
BESCHREIBUNG
Wert
clientId
Client-ID (GUID-Wert) der benutzerseitig zugewiesenen verwalteten Identität. ObjectId sollte nicht verwendet werden, wenn dies angegeben ist.
Zeichenfolge
objectId
Objekt-ID (GUID-Wert) der benutzerseitig zugewiesenen verwalteten Identität. ClientId sollte nicht verwendet werden, wenn dies angegeben ist.
Zeichenfolge
RunCommandInputParameter
Name
BESCHREIBUNG
Wert
name
Der Name des Run-Befehlsparameters.
Zeichenfolge (erforderlich)
value
Der Wert des Befehlsparameters run.
Zeichenfolge (erforderlich)
VirtualMachineRunCommandScriptSource
Name
BESCHREIBUNG
Wert
commandId
Gibt eine commandId des vordefinierten integrierten Skripts an.
Zeichenfolge
script
Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.
Zeichenfolge
scriptUri
Gibt den Speicherort für den Skriptdownload an. Dabei kann es sich entweder um einen SAS-URI eines Azure Storage-Blobs mit Lesezugriff oder um einen öffentlichen URI handeln.
Zeichenfolge
scriptUriManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die im Fall eines Azure Storage-Blobs Zugriff auf scriptUri hat. Verwenden Sie bei systemseitig zugewiesener Identität ein leeres Objekt. Stellen Sie sicher, dass das Azure Storage-Blob vorhanden ist und die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged.
Mit dieser Vorlage wird eine SharePoint-Abonnement-/2019/2016/2013-Farm mit einer umfangreichen Konfiguration erstellt, die eine manuelle Ausführung dauert, einschließlich einer Verbundauthentifizierung mit AD FS, einer OAuth-Vertrauensstellung, dem Benutzerprofildienst und einer Webanwendung mit 2 Zonen, die mehrere pfadbasierte und hostbasierte Websitesammlungen enthält. Auf den virtuellen SharePoint-Computern wird Chocolatey verwendet, um die neueste Version von Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer und 7-Zip zu installieren.
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp virtualMachines/runCommands kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Optional. Wenn dieser Wert auf TRUE festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird, und es wird nicht auf den Abschluss des Skripts gewartet.
bool
errorBlobManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die Zugriff auf das Storage-Blob errorBlobUri hat. Verwenden Sie bei systemseitig zugewiesener Identität ein leeres Objekt. Stellen Sie sicher, dass die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Mitwirkender an Storage-Blobdaten" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged
Gibt das Azure-Speicherblob an, in das der Skriptfehlerstream hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs- oder Schreibzugriff oder mit verwalteter Identität, um dem virtuellen Computer Zugriff auf das Blob zu gewähren. Weitere Informationen finden Sie unter errorBlobManagedIdentity-Parameter.
Zeichenfolge
outputBlobManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt bei systemseitig zugewiesener Identität. Stellen Sie sicher, dass die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged
Gibt das Azure Storage-Blob an, in das der Skriptausgabestream hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs- oder Schreibzugriff oder mit verwalteter Identität, um dem virtuellen Computer Zugriff auf das Blob zu gewähren. Weitere Informationen finden Sie unter outputBlobManagedIdentity-Parameter.
Das Timeout in Sekunden, um den Befehl ausführen zu können.
INT
treatFailureAsDeploymentFailure
Optional. Wenn auf true festgelegt ist, tritt bei jedem Fehler im Skript ein Fehler bei der Bereitstellung auf, und ProvisioningState wird als Fehler markiert. Wenn dieser Wert auf false festgelegt ist, gibt ProvisioningState nur an, ob der Ausführungsbefehl von der Erweiterungsplattform ausgeführt wurde oder nicht. Dies gibt nicht an, ob ein Skriptfehler bei Skriptfehlern aufgetreten ist. Siehe instance Ansicht des Ausführens des Befehls bei Skriptfehlern, um executionMessage, Output, Error zu sehen:https://aka.ms/runcommandmanaged#get-execution-status-and-results
bool
RunCommandManagedIdentity
Name
BESCHREIBUNG
Wert
clientId
Client-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ObjectId sollte nicht verwendet werden, wenn dies angegeben ist.
Zeichenfolge
objectId
Objekt-ID (GUID-Wert) der vom Benutzer zugewiesenen verwalteten Identität. ClientId sollte nicht verwendet werden, wenn dies angegeben ist.
Zeichenfolge
RunCommandInputParameter
Name
BESCHREIBUNG
Wert
name
Der Name des Befehlsparameters ausführen.
Zeichenfolge (erforderlich)
value
Der Wert des Befehlsparameters ausführen.
Zeichenfolge (erforderlich)
VirtualMachineRunCommandScriptSource
Name
BESCHREIBUNG
Wert
commandId
Gibt eine CommandId des vordefinierten integrierten Skripts an.
Zeichenfolge
script
Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.
Zeichenfolge
scriptUri
Gibt den Speicherort für den Skriptdownload an. Dabei kann es sich entweder um einen SAS-URI eines Azure-Speicherblobs mit Lesezugriff oder um einen öffentlichen URI handeln.
Zeichenfolge
scriptUriManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die im Fall eines Azure-Speicherblobs Zugriff auf scriptUri hat. Verwenden Sie ein leeres Objekt bei systemseitig zugewiesener Identität. Stellen Sie sicher, dass das Azure-Speicherblob vorhanden ist und die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged.
Mit dieser Vorlage wird eine SharePoint-Abonnementfarm /2019/2016/2013 mit einer umfangreichen Konfiguration erstellt, die eine manuelle Ausführung dauern würde, einschließlich einer Verbundauthentifizierung mit ADFS, einer OAuth-Vertrauensstellung, dem Benutzerprofildienst und einer Webanwendung mit 2 Zonen, die mehrere pfadbasierte und hostnamenbasierte Websitesammlungen enthält. Auf den virtuellen SharePoint-Computern wird Chocolatey verwendet, um die neueste Version von Notepad++, Visual Studio Code, Azure Data Studio, Fiddler, ULS Viewer und 7-Zip zu installieren.
Terraform (AzAPI-Anbieter) Ressourcendefinition
Der Ressourcentyp virtualMachines/runCommands kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/virtualMachines/runCommands-Ressource zu erstellen, fügen Sie der Vorlage die folgende Terraform-Ressource hinzu.
Optional. Wenn dieser Wert auf TRUE festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird, und es wird nicht auf den Abschluss des Skripts gewartet.
bool
errorBlobManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die Zugriff auf das Storage-Blob errorBlobUri hat. Verwenden Sie bei systemseitig zugewiesener Identität ein leeres Objekt. Stellen Sie sicher, dass die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Mitwirkender an Storage-Blobdaten" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged
Gibt das Azure Storage-Blob an, in das der Skriptfehlerstream hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs- oder Schreibzugriff, ODER verwenden Sie eine verwaltete Identität, um dem virtuellen Computer Zugriff auf das Blob zu gewähren. Weitere Informationen finden Sie unter errorBlobManagedIdentity-Parameter.
Zeichenfolge
outputBlobManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die Zugriff auf das OutputBlobUri-Speicherblob hat. Verwenden Sie bei systemseitig zugewiesener Identität ein leeres Objekt. Stellen Sie sicher, dass die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Mitwirkender an Storage-Blobdaten" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged
Gibt das Azure Storage-Blob an, in das der Skriptausgabestream hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs- oder Schreibzugriff, ODER verwenden Sie eine verwaltete Identität, um dem virtuellen Computer Zugriff auf das Blob zu gewähren. Weitere Informationen finden Sie unter outputBlobManagedIdentity-Parameter.
Das Timeout in Sekunden zum Ausführen des Ausführungsbefehls.
INT
treatFailureAsDeploymentFailure
Optional. Wenn true festgelegt ist, schlägt jeder Fehler im Skript die Bereitstellung fehl, und ProvisioningState wird als Fehler gekennzeichnet. Wenn dieser Wert auf false festgelegt ist, gibt ProvisioningState nur an, ob der Befehl run von der Erweiterungsplattform ausgeführt wurde oder nicht. Es würde nicht angeben, ob bei Skriptfehlern ein Skriptfehler aufgetreten ist. Siehe instance Ansicht des Ausführungsbefehls bei Skriptfehlern, um executionMessage, output, error zu sehen:https://aka.ms/runcommandmanaged#get-execution-status-and-results
bool
RunCommandManagedIdentity
Name
BESCHREIBUNG
Wert
clientId
Client-ID (GUID-Wert) der benutzerseitig zugewiesenen verwalteten Identität. ObjectId sollte nicht verwendet werden, wenn dies angegeben ist.
Zeichenfolge
objectId
Objekt-ID (GUID-Wert) der benutzerseitig zugewiesenen verwalteten Identität. ClientId sollte nicht verwendet werden, wenn dies angegeben ist.
Zeichenfolge
RunCommandInputParameter
Name
BESCHREIBUNG
Wert
name
Der Name des Run-Befehlsparameters.
Zeichenfolge (erforderlich)
value
Der Wert des Befehlsparameters run.
Zeichenfolge (erforderlich)
VirtualMachineRunCommandScriptSource
Name
BESCHREIBUNG
Wert
commandId
Gibt eine CommandId des vordefinierten integrierten Skripts an.
Zeichenfolge
script
Gibt den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.
Zeichenfolge
scriptUri
Gibt den Speicherort für den Skriptdownload an. Dabei kann es sich entweder um einen SAS-URI eines Azure-Speicherblobs mit Lesezugriff oder um einen öffentlichen URI handeln.
Zeichenfolge
scriptUriManagedIdentity
Benutzerseitig zugewiesene verwaltete Identität, die im Fall eines Azure-Speicherblobs Zugriff auf scriptUri hat. Verwenden Sie ein leeres Objekt bei systemseitig zugewiesener Identität. Stellen Sie sicher, dass das Azure-Speicherblob vorhanden ist und die verwaltete Identität zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten hat. Stellen Sie bei benutzerseitig zugewiesener Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zu verwalteter Identität und Befehl ausführen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.