### Example Output: Starting Update Installation Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/update/update-via-powershell-23h2.md This console output shows the result of initiating an update installation. The `$InstanceId` variable is assigned the value returned by the `Start-SolutionUpdate` command. ```powershell PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate ``` -------------------------------- ### Monitor Installing State Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/update/update-via-powershell-23h2.md Example output showing the update in the 'Installing' state. This phase includes the actual installation process and progress reporting. ```powershell Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState Version State HealthState ------- ----- ----------- 10.2408.2.7 Installing Unknown ``` -------------------------------- ### Start Full Update (Preparation + Installation) Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/update/update-phases-23h2.md Initiate a full update process that includes both the preparation and installation phases. This cmdlet should be used when you are ready to apply the update to the cluster. ```powershell # Start a full update (preparation + installation) Get-SolutionUpdate -Id | Start-SolutionUpdate ``` -------------------------------- ### Start Azure Stack Hub Update Installation Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/update/update-via-powershell-23h2.md Execute this command to begin the installation of a downloaded and readiness-checked update. The command returns an instance ID that can be used for troubleshooting. ```powershell $InstanceId = Get-SolutionUpdate -Id | Start-SolutionUpdate ``` -------------------------------- ### Example Output for Solution Update Environment Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/update/update-via-powershell-23h2.md This is a sample console output showing the state and current version of the solution update environment after a successful installation. ```console PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion State CurrentVersion ----- -------------- AppliedSuccessfully 10.2408.2.7 ``` -------------------------------- ### Example output of cloud-init installation and version check Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-image-red-hat-enterprise.md This console output shows the result of installing cloud-init and checking its version on a Red Hat Enterprise Linux system. ```console [hcitest@localhost ~]$ sudo yum install -y cloud-init Installed: cloud-init-23.4-7.el9_4.noarch dhcp-client-12:4.4.2-19.bl.el9.x86_64 dhcp-common-12:4.4.2-19.bl.el9.noarch geolite2-city-20191217-6.el9.noarch geolite2-country-20191217-6.el9.noarch ipcalc-l.0.0-5.el9.x86_64 python3-attrs-20.3.0-7.el9.noarch python3-babel-2.9.1-2.el9.noarch python3-configob j-5.0.6-25.el9.noarch python3-jinja2-2.11.3-5.el9.noarch python3-j sonpatch-1.21-16.el9.noarch python3-j sonpointer-2.0-4.el9.noarch python3-j sonschema-3.2.0-13.el9.noarch python3-markupsafe-l.1.1-12.el9.x86_64 python3-netifaces-0.10.6-15.el9.noarch python3-oauthlib-3.1.1-5.el9.noarch python3-prettytable-0.7.2-27.el9.noarch python3-pyrsistent-0.17.3-8.el9.noarch python3-pyserial-3.4-12.el9.noarch python3-pytz-2021.1-5.el9.noarch Complete! [hcitest@localhost ~]$ cloud-init —version /usr/bin/cloud-init 23.4-7.el9_4 ``` -------------------------------- ### Review conversion output Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/operator/azure-stack-prepare-pki-certs.md Example output showing the start of the conversion process. ```powershell ConvertTo-AzsPFX v1.2005.1286.272 started. ``` -------------------------------- ### Example Output for Operating System Version Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/update/update-via-powershell-23h2.md This is a sample console output displaying the Windows operating system version, which should be checked against the installed recipe version. ```console PS C:\Users\lcmuser> cmd /c ver Microsoft Windows [Version 10.0.25398.1189] PS C:\Users\lcmuser> ``` -------------------------------- ### Run Go web app Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/user/azure-stack-dev-start-howto-vm-go.md Starts the Go web application using the 'go run' command. This should be done after cloning the repository and getting dependencies, while connected to your VM via SSH. ```bash go run hello-world.go ``` -------------------------------- ### Download and prepare the quickstart script Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/aks-edge-howto-deploy-azure-iot.md Use these commands to download the deployment script and configuration templates, then set the execution policy to allow the script to run. ```powershell $giturl = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools" $url = "$giturl/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1" Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStartForAio.ps1 -UseBasicParsing Invoke-WebRequest -Uri "$giturl/aio-aide-userconfig.json" -OutFile .\aio-aide-userconfig.json -UseBasicParsing Invoke-WebRequest -Uri "$giturl/aio-aksedge-config.json" -OutFile .\aio-aksedge-config.json -UseBasicParsing Unblock-File .\AksEdgeQuickStartForAio.ps1 Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force ``` -------------------------------- ### Install-AksHciAdAuth Usage Examples Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/reference/ps/install-akshciadauth.md Examples demonstrating command usage for different cluster host configurations. ```powershell Install-AksHciAdAuth -name mynewcluster1 -keytab <.\current.keytab> -previousKeytab <.\previous.keytab> -SPN -adminUser CONTOSO\Bob ``` ```powershell Install-AksHciAdAuth -name mynewcluster1 -keytab .\current.keytab -SPN k8s/apiserver@CONTOSO.COM -adminUser contoso\bob ``` ```powershell Install-AksHciAdAuth -name mynewcluster1 -keytab .\current.keytab -SPN k8 ``` -------------------------------- ### Install Azure IoT Edge Runtime Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/attach-gpu-to-linux-vm.md Installs the Azure IoT Edge runtime on an Ubuntu 18.04 system. This command assumes you are skipping the runtime installation step as per the guide. ```shell curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/ curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/ sudo apt-get update sudo apt-get install iotedge ``` -------------------------------- ### Retrieve usage aggregates via GET request Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/operator/azure-stack-provider-resource-api.md Example of the HTTP GET request structure for querying subscriber usage aggregates. ```http GET /subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0 ``` -------------------------------- ### Start the Node.js application Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/user/azure-stack-dev-start-howto-vm-nodejs.md After installing dependencies, use this command to start the Express application server. The application will typically run on port 3000. ```bash npm start ``` -------------------------------- ### Deploy example stateful set application Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/user/kubernetes-aks-engine-container-storage-interface.md Deploys a sample stateful set to verify the CSI driver functionality. ```bash kubectl apply -f https://raw.githubusercontent.com/kubernetes-sigs/azuredisk-csi-driver/master/deploy/example/statefulset.yaml ``` -------------------------------- ### Example Output for Get-ApplianceLogCollectionJobStatus Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/disconnected-operations-on-demand-logs.md Example output demonstrating the status of a log collection job, including its state, start time, and end time. ```Console PS C:\Users\administrator.s46r2004\Documents> Get-ApplianceLogCollectionJobStatus -OperationId $operationId VERBOSE: [2023-04-09 22:35:29Z] [Invoke-ScriptsWithRetry] Executing 'Get log collection job status ...' with timeout 600 seconds ... VERBOSE: [2023-04-09 22:35:29Z] [Invoke-ScriptsWithRetry] [CHECK] [Attempt 0] for task 'Get log collection job status ...' ... VERBOSE: [2023-04-09 22:35:29Z] [Invoke-ScriptsWithRetry] Task 'Get log collection job status ...' succeeded. StatusRecord @{Instance Id=; State=Running; StartTime=0001-01-01T00:00:00; EndTime=0001-01-01T00:00:00} ``` -------------------------------- ### Install Azure tailored kernel on Linux VM Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-image-linux-sysprep.md Install the Azure tailored kernel, which is required for your VM to get an IP for the network interface. ```azurecli sudo apt install linux-azure -y ``` -------------------------------- ### Start-AzureStack PowerShell Example Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/reference/pep/Start-AzureStack.md Basic usage of the Start-AzureStack command. ```powershell PS C:\> ``` -------------------------------- ### Start HIMDS Service Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/disconnected-operations-known-issues.md If the HIMDS service is found to be stopped, use this command to start it. This can resolve issues where cloud deployment gets stuck. ```powershell Start-Service HIMDS ``` -------------------------------- ### Sample Azure Local VM Image Deployment Parameters Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/multi-rack/multi-rack-virtual-machine-image-storage-account.md Provides a concrete example of setting deployment parameters, including a sample SAS URL for the VM image. This demonstrates the expected format for each variable. ```powershell PS C:\Users\azcli> $subscription = "" PS C:\Users\azcli> $resourceGroup = "mylocal-rg" PS C:\Users\azcli> $location = "eastus" PS C:\Users\azcli> $osType = "Windows" PS C:\Users\azcli> $imageName = "mylocal-storacctimage" PS C:\Users\azcli> $imageSourcePath = '"https://vmimagevhdsa1.blob.core.windows.net/vhdcontainer/Windows_InsiderPreview_ServerStandard_en-us_VHDX_25131.vhdx?sp=r"&"st=2022-08-05T18:41:41Z"&"se=2022-08-06T02:41:41Z"&"spr=https"&"sv=2021-06-08"&"sr=b"&"sig=X7A98cQm%2FmNRaHmTbs9b4OWVv%2F9Q%2FJkWDBHVPyAc8jo%3D"' ``` -------------------------------- ### Kubernetes node output example Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/deploy-gpu-node-pool-22h2.md Example output from `kubectl get nodes`, showing node status, roles, age, and Kubernetes version. ```output NAME STATUS ROLES AGE VERSION moc-l9qz36vtxzj Ready control-plane,master 6m14s v1.22.6 moc-lhbkqoncefu Ready 3m19s v1.22.6 moc-li87udi8l9s Ready 3m5s v1.22.6 ``` -------------------------------- ### Start Virtual Machine Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/deploy/deployment-virtual.md Starts the specified virtual machine. Ensure all previous configuration steps are completed before starting. ```PowerShell Start-VM "Node1" ``` -------------------------------- ### Confirm Azure Stack Hub PowerShell Installation Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/operator/powershell-install-az-module.md Verifies the installation of Az and AzureStack modules by listing available modules starting with 'Az' and 'Azs'. ```powershell Get-Module -Name "Az*" -ListAvailable Get-Module -Name "Azs*" -ListAvailable ``` -------------------------------- ### Retrieve usage aggregates via GET request Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/operator/azure-stack-tenant-resource-usage-api.md Example of a GET request URI for fetching usage aggregates within a specified time frame. ```html GET /subscriptions/sub1/providers/Microsoft.Commerce/UsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&api-version=1.0 ``` -------------------------------- ### Prepare Active Directory with Specific Credentials and OU Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/deploy/deployment-prep-active-directory.md This example demonstrates how to prepare Active Directory by creating a specific OU and providing the user credentials. Ensure the password meets complexity requirements and the username adheres to the specified format. ```powershell PS C:\work> $password = ConvertTo-SecureString '' -AsPlainText -Force PS C:\work> $user = "lcmuser" PS C:\work> $credential = New-Object System.Management.Automation.PSCredential ($user, $password) PS C:\work> New-HciAdObjectsPreCreation -AzureStackLCMUserCredential $credential -AsHciOUName "OU=ms309,DC=PLab8,DC=nttest,DC=microsoft,DC=com" PS C:\work> ``` -------------------------------- ### Get installation directory for kubelogin.exe Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/azure-rbac-aks-hybrid.md Retrieve the installation directory path for the kubelogin.exe binary. This is useful for copying the executable to the correct location on your server or client machine. ```powershell $workingdir = (Get-AksHciConfig).Akshci.installationPackageDir ``` -------------------------------- ### Sample output of storage path creation Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/create-storage-path.md This is a sample output demonstrating a successful storage path creation, including its properties and provisioning state. ```console PS C:\windows\system32> $storagepathname="test-storagepath" PS C:\windows\system32> $path="C:\ClusterStorage\UserStorage_1\mypath" PS C:\windows\system32> $subscription="" PS C:\windows\system32> $resource_group="mylocal-rg" PS C:\windows\system32> $customLocationID="/subscriptions//resourceGroups/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl" PS C:\windows\system32> az stack-hci-vm storagepath create --name $storagepathname --resource-group $resource_group --custom-location $customLocationID --path $path Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus { "extendedLocation": { "name": "/subscriptions//resourceGroups/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl", "type": "CustomLocation" }, "id": "/subscriptions//resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath", "location": "eastus", "name": "test-storagepath", "properties": { "path": "C:\\ClusterStorage\\UserStorage_1\\mypath", "provisioningState": "Succeeded", "status": { "availableSizeMB": 36761, "containerSizeMB": 243097 } }, "resourceGroup": "mylocal-rg", "systemData": { "createdAt": "2023-10-06T04:45:30.458242+00:00", "createdBy": "guspinto@contoso.com", "createdByType": "User", "lastModifiedAt": "2023-10-06T04:45:57.386895+00:00", "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05", "lastModifiedByType": "Application" }, "tags": null, "type": "microsoft.azurestackhci/storagecontainers" } ``` -------------------------------- ### Sample parameter values for VM image creation (Azure CLI) Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-image-storage-account.md Provides an example of how to set the parameters for creating a VM image from a storage account, including a sample SAS URL for the source image. ```powershell PS C:\Users\azcli> $subscription = "" PS C:\Users\azcli> $resource_group = "mylocal-rg" PS C:\Users\azcli> $location = "eastus" PS C:\Users\azcli> $osType = "Windows" PS C:\Users\azcli> $imageName = "mylocal-storacctimage" PS C:\Users\azcli> $imageSourcePath = '"https://vmimagevhdsa1.blob.core.windows.net/vhdcontainer/Windows_InsiderPreview_ServerStandard_en-us_VHDX_25131.vhdx?sp=r"&"st=2022-08-05T18:41:41Z"&"se=2022-08-06T02:41:41Z"&"spr=https"&"sv=2021-06-08"&"sr=b"&"sig=X7A98cQm%2FmNRaHmTbs9b4OWVv%2F9Q%2FJkWDBHVPyAc8jo%3D"' ``` -------------------------------- ### Start AKS Deployment Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/prestage-cluster-service-host-create.md Run this command to start the installation of AKS agents and the AKS host after configuration. Ensure you do not delete the created Kubernetes - Azure Arc resource. ```powershell Install-AksHci ``` -------------------------------- ### Example output of yum clean all and cloud-init clean Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-azure-marketplace-red-hat.md This is an example output demonstrating the successful execution of 'yum clean all' and 'cloud-init clean' commands. ```console [contosotest@localhost ~]$ sudo yum clean all Updating Subscription Management repositories. 17 files removed [contosotest@localhost ~]$ sudo cloud-init clean ``` -------------------------------- ### Initiate Firmware Installation on Terminal Server Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/operator-nexus/howto-upgrade-os-of-terminal-server.md Starts the OS upgrade process on the Terminal Server using the uploaded firmware file. The server will automatically reboot after the installation. ```bash sudo puginstall --reboot-after /tmp/operations_manager-25.11.0-production-signed.raucb ``` -------------------------------- ### Sample Parameter Values for Azure Local VM Image Creation (Azure CLI) Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-image-azure-marketplace.md Provides a sample output demonstrating how to set the parameters for creating an Azure Local VM image using the Azure CLI. This includes example values for subscription ID, resource group, Marketplace image name, custom location, Azure Local instance location, and OS type/version. ```powershell PS C:\Users\azcli> $subscription = "" PS C:\Users\azcli> $resource_group = "mylocal-rg" PS C:\Users\azcli> $mktplaceImage= "mylocal-marketplaceimage" PS C:\Users\azcli> $customLocationName = "mylocal-cl" PS C:\Users\azcli> $customerLocationID /subscriptions$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName PS C:\Users\azcli> $location = "eastus" PS C:\Users\azcli> $ostype = "Windows" PS C:\Users\azcli> $version = "26100.4652.250808" ``` -------------------------------- ### Create Virtual Machine Configuration Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/user/azure-stack-quick-create-vm-windows-powershell.md Sets up VM credentials, OS configuration, image source, and disk properties before deploying the VM. ```powershell # Define a credential object to store the username and password for the VM $UserName='demouser' $Password='Password@123'| ConvertTo-SecureString -Force -AsPlainText $Credential=New-Object PSCredential($UserName,$Password) # Create the VM configuration object $VmName = "VirtualMachinelatest" $VmSize = "Standard_A1" $VirtualMachine = New-AzVMConfig ` -VMName $VmName ` -VMSize $VmSize $VirtualMachine = Set-AzVMOperatingSystem ` -VM $VirtualMachine ` -Windows ` -ComputerName "MainComputer" ` -Credential $Credential -ProvisionVMAgent $VirtualMachine = Set-AzVMSourceImage ` -VM $VirtualMachine ` -PublisherName "MicrosoftWindowsServer" ` -Offer "WindowsServer" ` -Skus "2016-Datacenter" ` -Version "latest" # Sets the operating system disk properties on a VM. $VirtualMachine = Set-AzVMOSDisk ` -VM $VirtualMachine ` -CreateOption FromImage | ` Set-AzVMBootDiagnostic -ResourceGroupName $ResourceGroupName ` -StorageAccountName $StorageAccountName -Enable |` Add-AzVMNetworkInterface -Id $nic.Id # Create the VM. New-AzVM ` -ResourceGroupName $ResourceGroupName ` -Location $location ` -VM $VirtualMachine ``` -------------------------------- ### Example Initialization Variables Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/deploy/deployment-without-azure-arc-gateway.md Example values for subscription ID, resource group, region, tenant ID, proxy server, proxy bypass list, and target solution version used during Azure Arc registration. ```powershell $Subscription = "Subscription ID" $RG = "myashcirg" $Region = "eastus" $Tenant = "Tenant ID" $ProxyServer = "http://192.168.10.10:8080" $ProxyBypassList = "localhost,127.0.0.1,*.contoso.com,machine1,machine2,machine3,machine4,machine5,192.168.*.*,AzureLocal-1" $TargetSolutionVersion = "12.2602.1002.10" ``` -------------------------------- ### Example Node Status Output Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/node-repair.md This is an example of the expected output when checking node status using 'kubectl get nodes'. It displays nodes that are currently in a 'Ready' state. ```output NAME STATUS ROLES AGE VERSION moc-l2tlqojhk2d Ready master 46h v1.19.7 moc-l8h8i6lxk1h Ready 46h v1.19.7 moc-lqnjufwo2cy Ready master 46h v1.19.7 moc-ltyl8mqy47z Ready 47h v1.19.7 moc-lwn5xnrapnj Ready master 47h v1.19.7 moc-wvt025q406z Ready 47h v1.19.7 ``` -------------------------------- ### View cloud-init configuration file Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-azure-marketplace-ubuntu.md Display the content of the 90_dpkg.cfg file to inspect the current data source configuration. ```bash cat 90_dpkg.cfg ``` -------------------------------- ### Create Storage Resources Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/user/azure-stack-quick-create-vm-windows-powershell.md Sets up a storage account for boot diagnostics and configures the current storage context. ```powershell # Create variables to store the storage account name and the storage account SKU information $StorageAccountName = "mystorageaccount" $SkuName = "Standard_LRS" # Create a new storage account $StorageAccount = New-AzStorageAccount ` -Location $location ` -ResourceGroupName $ResourceGroupName ` -Type $SkuName ` -Name $StorageAccountName Set-AzCurrentStorageAccount ` -StorageAccountName $storageAccountName ` -ResourceGroupName $resourceGroupName ``` ```powershell # Create variables to store the storage account name and the storage account SKU information $StorageAccountName = "mystorageaccount" $SkuName = "Standard_LRS" # Create a new storage account $StorageAccount = New-AzureRMStorageAccount ` -Location $location ` -ResourceGroupName $ResourceGroupName ` -Type $SkuName ` -Name $StorageAccountName Set-AzureRMCurrentStorageAccount ` -StorageAccountName $storageAccountName ` -ResourceGroupName $resourceGroupName ``` -------------------------------- ### Operation Status Response Example Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/operator-nexus/concepts-disable-border-gateway-protocol-neighbors.md This is an example of the expected JSON output when checking the status of an operation. It includes details like start time, end time, and the final status. ```json { "endTime": "2024-XX-XXT10:14:13.2334379Z", "id": "/subscriptions/XXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-DA565ABE0036AB", "name": "e239299a-8c71-426e-8460-58d4c0b470e2*E98FEC8C2D6479A6C0A450CE6E20DA4C9DDBF225A07F7F4850DA565ABE0036AB", "properties": null, "resourceId": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroup/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", "startTime": "2024-XX-XXT10:13:52.0438351Z", "status": "Succeeded" } ``` -------------------------------- ### Example Hardware Support Archive Structure Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/operator-nexus/howto-baremetal-run-data-extract.md This example shows the typical file structure within a collected hardware support archive, including system information and logs. ```text Archive: TSR20240227164024_FM56PK3.pl.zip creating: tsr/hardware/ creating: tsr/hardware/spd/ creating: tsr/hardware/sysinfo/ creating: tsr/hardware/sysinfo/inventory/ inflating: tsr/hardware/sysinfo/inventory/sysinfo_CIM_BIOSAttribute.xml inflating: tsr/hardware/sysinfo/inventory/sysinfo_CIM_Sensor.xml inflating: tsr/hardware/sysinfo/inventory/sysinfo_DCIM_View.xml inflating: tsr/hardware/sysinfo/inventory/sysinfo_DCIM_SoftwareIdentity.xml inflating: tsr/hardware/sysinfo/inventory/sysinfo_CIM_Capabilities.xml inflating: tsr/hardware/sysinfo/inventory/sysinfo_CIM_StatisticalData.xml creating: tsr/hardware/sysinfo/lcfiles/ inflating: tsr/hardware/sysinfo/lcfiles/lclog_0.xml.gz inflating: tsr/hardware/sysinfo/lcfiles/curr_lclog.xml creating: tsr/hardware/psu/ creating: tsr/hardware/idracstateinfo/ inflating: tsr/hardware/idracstateinfo/avc.log extracting: tsr/hardware/idracstateinfo/avc.log.persistent.1 [..snip..] ``` -------------------------------- ### Start Azure Arc VM and Verify Status Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/manage-arc-virtual-machines.md Use these commands to start a paused Azure Arc virtual machine and then verify that it is running. This follows the pause and show example. ```bash #Start the VM after it was paused. [v-host1]: PS C:\Users\HCIDeploymentUser> az stack-hci-vm start --name $vmName --resource-group $rg Inside _start_initial/subscriptions//resourceGroups//providers/Microsoft.HybridCompute/machines/testvm0012024-02-01-preview/https://management.azure.com/subscriptions//resourceGroups//providers/Microsoft.HybridCompute/machines/testvm001/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default/start?api-version=2024-02-01-preview #Show the current state of the VM. The VM should be running. [v-host1]: PS C:\Users\HCIDeploymentUser> az stack-hci-vm show -g $rg --name $vmName { "attestationStatus": null, "virtualmachineinstance": { "extendedLocation": { "name": "/subscriptions//resourcegroups//providers/Microsoft.ExtendedLocation/customLocations/s-cluster-customlocation", "type": "CustomLocation" }, ``` -------------------------------- ### Start VM Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/load-balance-multiple-networks.md Starts the virtual machine after all network adapter configurations are complete. ```powershell $vm | Start-Vm ``` -------------------------------- ### Get Velero Command Help Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/backup-workload-cluster.md Use the `--help` flag with any Velero command to view all available options and subcommands. This example shows how to get help for restore commands. ```bash velero restore --help ``` ```output velero restore [command] Available Commands: create Create a restore delete Delete restores describe Describe restores get Get restores logs Get restore logs ``` -------------------------------- ### Example: Rack-by-Rack Upgrade with PercentSuccess Threshold Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/operator-nexus/howto-cluster-runtime-upgrade.md This example configures a Rack-by-Rack upgrade strategy with a 60% success threshold and a 1-minute wait time between racks. It demonstrates how to set specific parameters for a runtime upgrade. ```azurecli az networkcloud cluster update --name "" \ --resource-group "" \ --update-strategy strategy-type="Rack" threshold-type="PercentSuccess" \ threshold-value=60 wait-time-minutes=1 \ --subscription "" ``` -------------------------------- ### Example AKS cluster node list Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/howto-create-windows-node-pools.md This is an example of the output from `kubectl get node -A`. It lists the nodes in the cluster, their status (should be 'Ready'), roles, age, and Kubernetes version. ```output NAME STATUS ROLES AGE VERSION moc-lesdc78871d Ready control-plane 6d8h v1.26.3 moc-lupeeyd0f8c Ready 6d8h v1.26.3 moc-ww2c8d5ranw Ready 7m18s v1.26.3 ``` -------------------------------- ### Install Guest Agent on Linux VM Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/migrate/migrate-enable-guest-management.md Use this command to mount the guest agent ISO, install the agent, and start the service on a Linux VM. Ensure you have the correct ISO label. ```azurecli migration@migration-virtual-machine: $ sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /nociso && bash /mociso/install.sh && umount /mociso && rm -df/mociso && eject LABEL=mocguestagentprov' [sudo] password for migration: mount: /moctso: WARNING: device write-protected, mounted read-only. Loading configuration version 've.16.5'... The agent could not find the '/opt/mocguestagent/v0.16.5/config.yaml' config file. Looking for older versions to upgrade from... Service installed. Service started. The guest agent was successfully installed. ``` -------------------------------- ### Parameter Configuration Examples Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/reference/ps/enable-akshciarcconnection.md Configuration blocks for individual command parameters. ```yaml Type: System.String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: System.String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: System.String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: System.String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: System.String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: System.String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -------------------------------- ### Install and verify cloud-init Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/virtual-machine-image-red-hat-enterprise.md Install the cloud-init package on the RHEL VM and then check the installed version. This is a prerequisite for cloud-init based VM configuration. ```bash sudo yum install -y cloud-init cloud-init --version ``` -------------------------------- ### Install SDN AKS-HCI Log Collector and Get Logs Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/software-defined-networking.md Installs the necessary PowerShell module and then runs the command to collect logs. Ensure you are in an environment with SDN and AKS on Windows Server. ```powershell Install-Module -Name AksHciSdnLogCollector -Repository PSGallery ``` ```powershell Get-AksHciLogsSdn ``` -------------------------------- ### Get current version of AKS hybrid Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/reference/ps/get-akshciversion.md Retrieves the current Kubernetes version installed on the AKS hybrid cluster. ```powershell Get-AksHciVersion ``` -------------------------------- ### Sample Terraform Provider Versions Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-local/manage/create-arc-virtual-machines.md This is an example output showing the versions of Terraform and its providers. Ensure your installed versions are compatible. ```output Terraform vi.9.8 on windows_amd64 + provider registry.terraform.io/azure/azapi vl.15.0 + provider registry.terraform.io/azure/modtm V0.3.2 + provider registry.terraform.io/hashicorp/azurerm v3.116.0 + provider registry.terraform.io/hashicorp/random V3.6.3 ``` -------------------------------- ### Application Registration Output Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/azure-stack/operator/give-app-access-to-resources.md Example output displaying the application identifier and client credentials after successful registration. ```output ApplicationIdentifier : S-1-5-21-1634563105-1224503876-2692824315-2623 ClientId : 11112222-bbbb-3333-cccc-4444dddd5555 Thumbprint : ApplicationName : Azurestack-YourApp-6967581b-497e-4f5a-87b5-0c8d01a9f146 ClientSecret : 6RUWLRoBw3EebBLgaWGiowCkoko5_j_ujIPjA8dS PSComputerName : azs-ercs01 RunspaceId : 286daaa1-c9a6-4176-a1a8-03f543f90998 ``` -------------------------------- ### Get MinIO Service External IP Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/backup-workload-cluster.md Retrieves the external IP address assigned to the MinIO service. This IP is needed for Velero installation. ```bash kubectl get svc ``` -------------------------------- ### Example command output Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/operator-nexus/howto-baremetal-run-read.md This is an example of the output you might receive after running commands. It shows the results of 'hostname' and 'ping', along with a link to the full output in a storage blob. ```output ====Action Command Output==== + hostname rack1compute01 + ping 198.51.102.1 -c 3 PING 198.51.102.1 (198.51.102.1) 56(84) bytes of data. --- 198.51.102.1 ping statistics --- 3 packets transmitted, 0 received, 100% packet loss, time 2049ms ================================ Script execution result can be found in storage account: https://.blob.core.windows.net/bmm-run-command-output/a8e0a5fe-3279-46a8-b995-51f2f98a18dd-action-bmmrunreadcmd.tar.gz?se=2023-04-14T06%3A37%3A00Z&sig=XXX&sp=r&spr=https&sr=b&st=2023-04-14T02%3A37%3A00Z&sv=2019-12-12 ``` -------------------------------- ### Get IDs for Custom Location Configuration Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/aks-vmware-install-kubernetes-extension.md Retrieves the resource IDs for the Arc appliance and the Kubernetes extension required for custom location setup. ```azurecli ### $extension_name = 'hybridaksopext' $ArcApplianceResourceId = (az arcappliance show -g $resource_group -n $appliance_name --query id -o tsv) $ClusteraksExtensionId = (az k8s-extension show -g $resource_group -c $appliance_name --cluster-type appliances --name $extension_name --query id -o tsv) ``` -------------------------------- ### Deploy with static IP environment Source: https://github.com/microsoftdocs/azure-stack-docs/blob/main/AKS-Arc/reference/ps/new-akshciclusternetwork.md Examples for configuring a virtual network with static IP addresses. ```powershell $vnet = New-AksHciClusterNetwork -name -vswitchName -gateway -dnsServers -ipAddressPrefix -vipPoolStart -vipPoolEnd -k8sNodeIpPoolStart -k8sNodeIpPoolEnd ``` ```powershell $vnet = New-AksHciClusterNetwork -name -vswitchName -gateway -dnsServers -ipAddressPrefix -vipPoolStart -vipPoolEnd -k8sNodeIpPoolStart -k8sNodeIpPoolEnd -vlanID ```