New-AzNetworkManager
Creates a network manager.
Syntax
New-AzNetworkManager
-Name <String>
-ResourceGroupName <String>
-Location <String>
[-Description <String>]
[-Tag <Hashtable>]
-NetworkManagerScope <PSNetworkManagerScopes>
-NetworkManagerScopeAccess <NetworkManagerScopeAccessType[]>
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The New-AzNetworkManager cmdlet creates a network manager.
Examples
Example 1: Creates a connectivity network manager.
$subscriptions = @("/subscriptions/0fd190fa-dd1c-4724-b7f6-c5cc3ba5c884")
$managementGroups = @("/providers/Microsoft.Management/managementGroups/PowerShellTest")
$scope = New-AzNetworkManagerScope -Subscription $subscriptions -ManagementGroup $managementGroups
$access = @("Connectivity")
New-AzNetworkManager -ResourceGroupName "psResourceGroup" -Name "psNetworkManager" -NetworkManagerScope $scope -NetworkManagerScopeAccess $access -Location "westus"
Location : westus
Tag : {}
NetworkManagerScopes : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSNetworkManagerScopes
NetworkManagerScopeAccesses : {Connectivity}
NetworkManagerScopeAccessesText : [
"Connectivity"
]
NetworkManagerScopesText : {
"ManagementGroups": [
"/providers/Microsoft.Management/managementGroups/PowerShellTest"
],
"Subscriptions": [
"/subscriptions/0fd190fa-dd1c-4724-b7f6-c5cc3ba5c884"
]
}
TagsTable :
DisplayName :
Description :
Type : Microsoft.Network/networkManagers
ProvisioningState : Succeeded
SystemData : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText : {
"CreatedBy": "jaredgorthy@microsoft.com",
"CreatedByType": "User",
"CreatedAt": "2022-08-07T04:12:51.7463424Z",
"LastModifiedBy": "jaredgorthy@microsoft.com",
"LastModifiedByType": "User",
"LastModifiedAt": "2022-08-07T04:12:51.7463424Z"
}
Name : psNetworkManager
Etag :
Id : /subscriptions/f0dc2b34-dfad-40e4-83e0-2309fed8d00b/resourceGroups/psResourceGroup/providers/Microsoft.Network/networkManagers/psNetworkManager
Creates a network manager with connectivity access in West US, with a subscription and management group in scope.
Example 2: Creates a security admin network manager.
$subscriptions = @("/subscriptions/0fd190fa-dd1c-4724-b7f6-c5cc3ba5c884")
$scope = New-AzNetworkManagerScope -Subscription $subscriptions
$access = @("SecurityAdmin")
New-AzNetworkManager -ResourceGroupName "psResourceGroup" -Name "psNetworkManager" -NetworkManagerScope $scope -NetworkManagerScopeAccess $access -Location "westus"
Location : westus
Tag : {}
NetworkManagerScopes : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSNetworkManagerScopes
NetworkManagerScopeAccesses : {"SecurityAdmin"}
NetworkManagerScopeAccessesText : [
"SecurityAdmin"
]
NetworkManagerScopesText : {
"Subscriptions": [
"/subscriptions/0fd190fa-dd1c-4724-b7f6-c5cc3ba5c884"
]
}
TagsTable :
DisplayName :
Description :
Type : Microsoft.Network/networkManagers
ProvisioningState : Succeeded
SystemData : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText : {
"CreatedBy": "jaredgorthy@microsoft.com",
"CreatedByType": "User",
"CreatedAt": "2022-08-07T04:12:51.7463424Z",
"LastModifiedBy": "jaredgorthy@microsoft.com",
"LastModifiedByType": "User",
"LastModifiedAt": "2022-08-07T04:12:51.7463424Z"
}
Name : psNetworkManager
Etag :
Id : /subscriptions/f0dc2b34-dfad-40e4-83e0-2309fed8d00b/resourceGroups/psResourceGroup/pr
oviders/Microsoft.Network/networkManagers/psNetworkManager
Creates a network manager with security administrator access in West US, with a subscription in scope.
Parameters
-AsJob
Run cmdlet in the background
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Description.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Do not ask for confirmation if you want to overwrite a resource
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
location.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
The resource name.
Type: | String |
Aliases: | ResourceName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NetworkManagerScope
Network Manager Scope
Type: | PSNetworkManagerScopes |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NetworkManagerScopeAccess
Network Manager Scope Access.
Type: | Microsoft.Azure.Commands.Network.NewAzNetworkManagerCommand+NetworkManagerScopeAccessType[] |
Accepted values: | SecurityAdmin, Connectivity |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
The resource group name.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
A hashtable which represents resource tags.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
String[]