Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
Documentation location
- Loading branch information
Showing
23 changed files
with
60 additions
and
20 deletions.
There are no files selected for viewing
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
# Renaming used resources | ||
|
||
AutomatedLab offers the ability to select different resource names for your lab machines as well as virtual switches. | ||
While this feature is mainly intended for on-premises hypervisors like Hyper-V, Azure-based labs can also make | ||
use of the new resource naming. | ||
|
||
This feature is very useful for classroom deployments if students are using a shared hypervisor, as the same lab | ||
can be deployed multiple times. | ||
|
||
Both `Add-LabVirtualNetworkDefinition` as well as `Add-LabMachineDefinition` can use the `ResourceName` parameter. | ||
|
||
## Example | ||
|
||
```powershell | ||
foreach ($studentNumber in (1..10)) | ||
{ | ||
New-LabDefinition -Name $($studentNumber)POSH -DefaultVirtualizationEngine HyperV | ||
Add-LabMachineDefinition -Name DC01 -ResourceName $($studentNumber)DC01 -Roles RootDC -Domain contoso.com | ||
Install-Lab | ||
} | ||
``` | ||
|
||
In the sample, the resources deployed on Hyper-V will be prefixed with Studentxx, while each student uses | ||
the VM host name to interact with the machine. Specifying a resource name for the virtual network adapter | ||
in this case would not be necessary, as the default adapter name is equal to the lab name. |
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
Generally speaking AutomatedLab takes care of everything for you when deploying your labs on Azure. Since additional authentication is required it is possible that you need to login to your Azure account before using AutomatedLab. | ||
AutomatedLab works with Azure Resource Manager, so you can either execute the cmdlet `Connect-AzAccount` before deploying your lab or save your Azure Resource Manager profile. | ||
|
||
If you choose to login to your Azure account before a lab deployment your profile is being saved for you to be able to import the lab at a later stage. Since it is possible that your profile expires you might see an error message indicating your profile expiration. In that case, simply login to your Azure account again. | ||
|
||
```powershell | ||
New-LabDefinition -Name 'MyLab' -DefaultVirtualizationEngine Azure | ||
# Optional to set e.g. your preferred location | ||
Add-LabAzureSubscription -DefaultLocation 'West Europe' | ||
``` | ||
|
||
This will enable AutomatedLab to create a lab sources resource group for you as well as a separate resource group for each lab you deploy. Your lab resource group will contain the entire lab deployment and will be removed when you call `Remove-Lab`. |
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters