Job Definition Create - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

powershell_heavy

windows_first

missing_linux_example

Summary

The documentation provides detailed step-by-step instructions for creating and managing migration jobs using the Azure Portal and PowerShell, with all CLI-based examples exclusively using PowerShell cmdlets. There are no examples or references for performing these tasks using cross-platform tools such as Azure CLI, Bash, or Linux-native scripting. The PowerShell section assumes the user is familiar with PowerShell and does not mention Linux or macOS usage, nor does it provide equivalent commands for those environments. This creates a Windows-centric bias and may hinder Linux users from following the documentation effectively.

Recommendations

Add equivalent Azure CLI examples for all PowerShell cmdlets shown, ensuring Linux and macOS users can follow along without needing PowerShell.
Explicitly mention cross-platform compatibility where possible, and clarify if any features are Windows-only.
Include Bash script examples or notes for Linux users, especially for common automation scenarios.
Reorder or parallelize the documentation sections so that PowerShell and Azure CLI (or Bash) examples are presented side-by-side, rather than PowerShell-only.
Reference any platform-specific prerequisites or differences (e.g., installation of Azure CLI on Linux) to ensure parity.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-08-19 00:01	#85	completed	Clean
2025-07-13 21:37	#48	completed	Biased
2025-07-12 23:44	#41	cancelled	Biased

Flagged Code Snippets

      
##  Set variables
$subscriptionID     = "Your subscription ID"
$resourceGroupName  = "Your resource group name"
$storageMoverName   = "Your storage mover name"

##  Log into Azure with your Azure credentials
Connect-AzAccount -SubscriptionId $subscriptionID

##  Define the source endpoint: an NFS share in this example
##  There is a separate cmdlet for creating each type of endpoint.
##  (Each storage location type has different properties.)
##  Run "Get-Command -Module Az.StorageMover" to see a full list.
$sourceEpName        = "Your source endpoint name could be the name of the share"
$sourceEpDescription = "Optional, up to 1024 characters"
$sourceEpHost        = "The IP address or DNS name of the source share NAS or server"
$sourceEpExport      = "The name of your source share"
##  Note that Host and Export will be concatenated to [Host]:/[Export] to form the full path 
##  to the source NFS share

New-AzStorageMoverNfsEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Name $sourceEpName `
    -Host $sourceEpHost `
    -Export $sourceEpExport `
    -Description $sourceEpDescription # Description optional

##  Define the target endpoint: an Azure blob container in this example
$targetEpName          = "Target endpoint or blob container name"
$targetEpDescription   = "Optional, up to 1024 characters"
$targetEpContainer     = "The name of the target container in Azure"
$targetEpSaResourceId  = /subscriptions/<GUID>/resourceGroups/<name>/providers/`
                         Microsoft.Storage/storageAccounts/<storageAccountName>
##  Note: the target storage account can be in a different subscription and region than
##  the storage mover resource.
##
##  Only the storage account resource ID contains a fully qualified reference.

New-AzStorageMoverAzStorageContainerEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Name $targetEpName `
    -BlobContainerName $targetEpContainer `
    -StorageAccountResourceId $targetEpSaResourceId `
    -Description $targetEpDescription # Description optional

## Create a job definition resource
$projectName        = "Your project name"
$jobDefName         = "Your job definition name"
$JobDefDescription  = "Optional, up to 1024 characters"
$jobDefCopyMode     = "Additive" # Merges source into target. See description in portal tab.
#$jobDefCopyMode    = "Mirror" # Mirrors source into target. See description in portal tab.
$agentName          = "The name of an agent previously registered to the same storage mover resource"


New-AzStorageMoverJobDefinition `
    -Name $jobDefName `
    -ProjectName $projectName `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -CopyMode $jobDefCopyMode `
    -SourceName $sourceEpName `
    -TargetName $targetEpName `
    -AgentName $agentName `
    -Description $sourceEpDescription # Description optional