Create new navigation property to microsoftTunnelSites for deviceManagement
Permissions
Permission type
Permissions (from least to most privileged)
Delegated (work or school account)
DeviceManagementConfiguration.ReadWrite.All,
Delegated (personal Microsoft account)
Not supported
Application
DeviceManagementConfiguration.ReadWrite.All,
Parameters
-AdditionalProperties
Additional Parameters
Parameter properties
Type:
Hashtable
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-BodyParameter
Entity that represents a Microsoft Tunnel site
To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Parameter properties
Type:
IMicrosoftGraphMicrosoftTunnelSite
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
Create
Position:
Named
Mandatory:
True
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Description
The site's description (optional)
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-DisplayName
The display name for the site.
This property is required when a site is created.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Headers
Optional headers that will be added to the request.
Parameter properties
Type:
IDictionary
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Id
The unique identifier for an entity.
Read-only.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-InternalNetworkProbeUrl
The site's Internal Network Access Probe URL
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MicrosoftTunnelConfiguration
Entity that represents a collection of Microsoft Tunnel settings
To construct, see NOTES section for MICROSOFTTUNNELCONFIGURATION properties and create a hash table.
Parameter properties
Type:
IMicrosoftGraphMicrosoftTunnelConfiguration
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MicrosoftTunnelServers
A list of MicrosoftTunnelServers that are registered to this MicrosoftTunnelSite
To construct, see NOTES section for MICROSOFTTUNNELSERVERS properties and create a hash table.
Parameter properties
Type:
IMicrosoftGraphMicrosoftTunnelServer[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-PublicAddress
The site's public domain name or IP address
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ResponseHeadersVariable
Optional Response Headers Variable.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
RHV
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-RoleScopeTagIds
List of Scope Tags for this Entity instance
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UpgradeAutomatically
The site's automatic upgrade setting.
True for automatic upgrades, false for manual control
Parameter properties
Type:
SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UpgradeAvailable
The site provides the state of when an upgrade is available
Parameter properties
Type:
SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UpgradeWindowEndTime
The site's upgrade window end time of day
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UpgradeWindowStartTime
The site's upgrade window start time of day
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UpgradeWindowUtcOffsetInMinutes
The site's timezone represented as a minute offset from UTC
Parameter properties
Type:
Int32
Default value:
0
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
To create the parameters described below, construct a hash table containing the appropriate properties.
For information on hash tables, run Get-Help about_Hash_Tables.
BODYPARAMETER <IMicrosoftGraphMicrosoftTunnelSite>: Entity that represents a Microsoft Tunnel site
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[Description <String>]: The site's description (optional)
[DisplayName <String>]: The display name for the site.
This property is required when a site is created.
[InternalNetworkProbeUrl <String>]: The site's Internal Network Access Probe URL
[MicrosoftTunnelConfiguration <IMicrosoftGraphMicrosoftTunnelConfiguration>]: Entity that represents a collection of Microsoft Tunnel settings
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[AdvancedSettings <IMicrosoftGraphKeyValuePair- []>]: Additional settings that may be applied to the server
[Name <String>]: Name for this key-value pair
[Value <String>]: Value for this key-value pair
[DefaultDomainSuffix <String>]: The Default Domain appendix that will be used by the clients
[Description <String>]: The configuration's description (optional)
[DisableUdpConnections <Boolean?>]: When DisableUdpConnections is set, the clients and VPN server will not use DTLS connections to transfer data.
[DisplayName <String>]: The display name for the server configuration.
This property is required when a server is created.
[DnsServers <String- []>]: The DNS servers that will be used by the clients
[Ipv6Network <String>]: The IPv6 subnet that will be used to allocate virtual address for the clients
[LastUpdateDateTime <DateTime?>]: When the configuration was last updated
[ListenPort <Int32?>]: The port that both TCP and UPD will listen over on the server
[Network <String>]: The IPv4 subnet that will be used to allocate virtual address for the clients
[RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance
[RouteExcludes <String- []>]: Subsets of the routes that will not be routed by the server
[RouteIncludes <String- []>]: The routes that will be routed by the server
[RoutesExclude <String- []>]: Subsets of the routes that will not be routed by the server.
This property is going to be deprecated with the option of using the new property, 'RouteExcludes'.
[RoutesInclude <String- []>]: The routes that will be routed by the server.
This property is going to be deprecated with the option of using the new property, 'RouteIncludes'.
[SplitDns <String- []>]: The domains that will be resolved using the provided dns servers
[MicrosoftTunnelServers <IMicrosoftGraphMicrosoftTunnelServer- []>]: A list of MicrosoftTunnelServers that are registered to this MicrosoftTunnelSite
[Id <String>]: The unique identifier for an entity.
Read-only.
[AgentImageDigest <String>]: The digest of the current agent image running on this server.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported.
Read-only.
[DeploymentMode <MicrosoftTunnelDeploymentMode?>]: The available deployment modes for a managed Tunnel server.
The deployment mode is determined during the deployment depending on the Tunnel containers, namely standalone or as part of a pod, and whether the containers are running in rootful or rootless mode.
[DisplayName <String>]: The display name of the server.
It is the same as the host name during registration and can be changed later.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported.
Max allowed length is 200 chars.
[LastCheckinDateTime <DateTime?>]: Indicates when the server last checked in.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported Read-only.
[ServerImageDigest <String>]: The digest of the current server image running on this server.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported.
Read-only.
[TunnelServerHealthStatus <MicrosoftTunnelServerHealthStatus?>]: Enum of possible MicrosoftTunnelServer health status types
[PublicAddress <String>]: The site's public domain name or IP address
[RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance
[UpgradeAutomatically <Boolean?>]: The site's automatic upgrade setting.
True for automatic upgrades, false for manual control
[UpgradeAvailable <Boolean?>]: The site provides the state of when an upgrade is available
[UpgradeWindowEndTime <String>]: The site's upgrade window end time of day
[UpgradeWindowStartTime <String>]: The site's upgrade window start time of day
[UpgradeWindowUtcOffsetInMinutes <Int32?>]: The site's timezone represented as a minute offset from UTC
MICROSOFTTUNNELCONFIGURATION <IMicrosoftGraphMicrosoftTunnelConfiguration>: Entity that represents a collection of Microsoft Tunnel settings
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[AdvancedSettings <IMicrosoftGraphKeyValuePair- []>]: Additional settings that may be applied to the server
[Name <String>]: Name for this key-value pair
[Value <String>]: Value for this key-value pair
[DefaultDomainSuffix <String>]: The Default Domain appendix that will be used by the clients
[Description <String>]: The configuration's description (optional)
[DisableUdpConnections <Boolean?>]: When DisableUdpConnections is set, the clients and VPN server will not use DTLS connections to transfer data.
[DisplayName <String>]: The display name for the server configuration.
This property is required when a server is created.
[DnsServers <String- []>]: The DNS servers that will be used by the clients
[Ipv6Network <String>]: The IPv6 subnet that will be used to allocate virtual address for the clients
[LastUpdateDateTime <DateTime?>]: When the configuration was last updated
[ListenPort <Int32?>]: The port that both TCP and UPD will listen over on the server
[Network <String>]: The IPv4 subnet that will be used to allocate virtual address for the clients
[RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance
[RouteExcludes <String- []>]: Subsets of the routes that will not be routed by the server
[RouteIncludes <String- []>]: The routes that will be routed by the server
[RoutesExclude <String- []>]: Subsets of the routes that will not be routed by the server.
This property is going to be deprecated with the option of using the new property, 'RouteExcludes'.
[RoutesInclude <String- []>]: The routes that will be routed by the server.
This property is going to be deprecated with the option of using the new property, 'RouteIncludes'.
[SplitDns <String- []>]: The domains that will be resolved using the provided dns servers
MICROSOFTTUNNELSERVERS <IMicrosoftGraphMicrosoftTunnelServer- []>: A list of MicrosoftTunnelServers that are registered to this MicrosoftTunnelSite
[Id <String>]: The unique identifier for an entity.
Read-only.
[AgentImageDigest <String>]: The digest of the current agent image running on this server.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported.
Read-only.
[DeploymentMode <MicrosoftTunnelDeploymentMode?>]: The available deployment modes for a managed Tunnel server.
The deployment mode is determined during the deployment depending on the Tunnel containers, namely standalone or as part of a pod, and whether the containers are running in rootful or rootless mode.
[DisplayName <String>]: The display name of the server.
It is the same as the host name during registration and can be changed later.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported.
Max allowed length is 200 chars.
[LastCheckinDateTime <DateTime?>]: Indicates when the server last checked in.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported Read-only.
[ServerImageDigest <String>]: The digest of the current server image running on this server.
Supports: $filter, $select, $top, $skip, $orderby.
$search is not supported.
Read-only.
[TunnelServerHealthStatus <MicrosoftTunnelServerHealthStatus?>]: Enum of possible MicrosoftTunnelServer health status types