Entity that represents a collection of Microsoft Tunnel settings
To construct, see NOTES section for MICROSOFTTUNNELCONFIGURATION properties and create a hash table.
A list of MicrosoftTunnelServers that are registered to this MicrosoftTunnelSite
To construct, see NOTES section for MICROSOFTTUNNELSERVERS properties and create a hash table.
Credentials for a proxy server to use for the remote call
Parameter properties
Type:
System.Management.Automation.PSCredential
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyUseDefaultCredentials
Use the default credentials for the proxy
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
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:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
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:
System.String
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:
System.String[]
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
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:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
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:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
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:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
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:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
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:
System.Int32
Default value:
0
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WhatIf
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
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
INPUTOBJECT <IDeviceManagementIdentity>: Identity Parameter
[AdvancedThreatProtectionOnboardingDeviceSettingStateId <String>]: The unique identifier of advancedThreatProtectionOnboardingDeviceSettingState
[AlertRecordId <String>]: The unique identifier of alertRecord
[AlertRuleId <String>]: The unique identifier of alertRule
[AndroidForWorkAppConfigurationSchemaId <String>]: The unique identifier of androidForWorkAppConfigurationSchema
[AndroidManagedStoreAppConfigurationSchemaId <String>]: The unique identifier of androidManagedStoreAppConfigurationSchema
[AppLogCollectionRequestId <String>]: The unique identifier of appLogCollectionRequest
[AssignmentFilterEvaluationStatusDetailsId <String>]: The unique identifier of assignmentFilterEvaluationStatusDetails
[BrowserSharedCookieId <String>]: The unique identifier of browserSharedCookie
[BrowserSiteId <String>]: The unique identifier of browserSite
[BrowserSiteListId <String>]: The unique identifier of browserSiteList
[DataSharingConsentId <String>]: The unique identifier of dataSharingConsent
[DetectedAppId <String>]: The unique identifier of detectedApp
[DeviceAndAppManagementAssignmentFilterId <String>]: The unique identifier of deviceAndAppManagementAssignmentFilter
[DeviceCategoryId <String>]: The unique identifier of deviceCategory
[DeviceComplianceActionItemId <String>]: The unique identifier of deviceComplianceActionItem
[DeviceComplianceDeviceStatusId <String>]: The unique identifier of deviceComplianceDeviceStatus
[DeviceCompliancePolicyAssignmentId <String>]: The unique identifier of deviceCompliancePolicyAssignment
[DeviceCompliancePolicyId <String>]: The unique identifier of deviceCompliancePolicy
[DeviceCompliancePolicySettingStateSummaryId <String>]: The unique identifier of deviceCompliancePolicySettingStateSummary
[DeviceCompliancePolicyStateId <String>]: The unique identifier of deviceCompliancePolicyState
[DeviceComplianceScheduledActionForRuleId <String>]: The unique identifier of deviceComplianceScheduledActionForRule
[DeviceComplianceSettingStateId <String>]: The unique identifier of deviceComplianceSettingState
[DeviceComplianceUserStatusId <String>]: The unique identifier of deviceComplianceUserStatus
[DeviceConfigurationAssignmentId <String>]: The unique identifier of deviceConfigurationAssignment
[DeviceConfigurationConflictSummaryId <String>]: The unique identifier of deviceConfigurationConflictSummary
[DeviceConfigurationDeviceStatusId <String>]: The unique identifier of deviceConfigurationDeviceStatus
[DeviceConfigurationGroupAssignmentId <String>]: The unique identifier of deviceConfigurationGroupAssignment
[DeviceConfigurationId <String>]: The unique identifier of deviceConfiguration
[DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState
[DeviceConfigurationUserStatusId <String>]: The unique identifier of deviceConfigurationUserStatus
[DeviceHealthScriptAssignmentId <String>]: The unique identifier of deviceHealthScriptAssignment
[DeviceHealthScriptDeviceStateId <String>]: The unique identifier of deviceHealthScriptDeviceState
[DeviceHealthScriptId <String>]: The unique identifier of deviceHealthScript
[DeviceId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
[DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse
[DeviceManagementComplianceActionItemId <String>]: The unique identifier of deviceManagementComplianceActionItem
[DeviceManagementCompliancePolicyId <String>]: The unique identifier of deviceManagementCompliancePolicy
[DeviceManagementComplianceScheduledActionForRuleId <String>]: The unique identifier of deviceManagementComplianceScheduledActionForRule
[DeviceManagementConfigurationPolicyAssignmentId <String>]: The unique identifier of deviceManagementConfigurationPolicyAssignment
[DeviceManagementConfigurationPolicyId <String>]: The unique identifier of deviceManagementConfigurationPolicy
[DeviceManagementConfigurationPolicyTemplateId <String>]: The unique identifier of deviceManagementConfigurationPolicyTemplate
[DeviceManagementConfigurationSettingDefinitionId <String>]: The unique identifier of deviceManagementConfigurationSettingDefinition
[DeviceManagementConfigurationSettingId <String>]: The unique identifier of deviceManagementConfigurationSetting
[DeviceManagementConfigurationSettingTemplateId <String>]: The unique identifier of deviceManagementConfigurationSettingTemplate
[DeviceManagementDerivedCredentialSettingsId <String>]: The unique identifier of deviceManagementDerivedCredentialSettings
[DeviceManagementIntentAssignmentId <String>]: The unique identifier of deviceManagementIntentAssignment
[DeviceManagementIntentDeviceSettingStateSummaryId <String>]: The unique identifier of deviceManagementIntentDeviceSettingStateSummary
[DeviceManagementIntentDeviceStateId <String>]: The unique identifier of deviceManagementIntentDeviceState
[DeviceManagementIntentId <String>]: The unique identifier of deviceManagementIntent
[DeviceManagementIntentSettingCategoryId <String>]: The unique identifier of deviceManagementIntentSettingCategory
[DeviceManagementIntentUserStateId <String>]: The unique identifier of deviceManagementIntentUserState
[DeviceManagementResourceAccessProfileAssignmentId <String>]: The unique identifier of deviceManagementResourceAccessProfileAssignment
[DeviceManagementResourceAccessProfileBaseId <String>]: The unique identifier of deviceManagementResourceAccessProfileBase
[DeviceManagementScriptAssignmentId <String>]: The unique identifier of deviceManagementScriptAssignment
[DeviceManagementScriptDeviceStateId <String>]: The unique identifier of deviceManagementScriptDeviceState
[DeviceManagementScriptGroupAssignmentId <String>]: The unique identifier of deviceManagementScriptGroupAssignment
[DeviceManagementScriptId <String>]: The unique identifier of deviceManagementScript
[DeviceManagementScriptUserStateId <String>]: The unique identifier of deviceManagementScriptUserState
[DeviceManagementSettingCategoryId <String>]: The unique identifier of deviceManagementSettingCategory
[DeviceManagementSettingDefinitionId <String>]: The unique identifier of deviceManagementSettingDefinition
[DeviceManagementSettingInstanceId <String>]: The unique identifier of deviceManagementSettingInstance
[DeviceManagementTemplateId <String>]: The unique identifier of deviceManagementTemplate
[DeviceManagementTemplateId1 <String>]: The unique identifier of deviceManagementTemplate
[DeviceManagementTemplateSettingCategoryId <String>]: The unique identifier of deviceManagementTemplateSettingCategory
[DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent
[DeviceShellScriptId <String>]: The unique identifier of deviceShellScript
[EmbeddedSimActivationCodePoolAssignmentId <String>]: The unique identifier of embeddedSIMActivationCodePoolAssignment
[EmbeddedSimActivationCodePoolId <String>]: The unique identifier of embeddedSIMActivationCodePool
[EmbeddedSimDeviceStateId <String>]: The unique identifier of embeddedSIMDeviceState
[GroupPolicyConfigurationAssignmentId <String>]: The unique identifier of groupPolicyConfigurationAssignment
[GroupPolicyConfigurationId <String>]: The unique identifier of groupPolicyConfiguration
[GroupPolicyDefinitionValueId <String>]: The unique identifier of groupPolicyDefinitionValue
[GroupPolicyPresentationValueId <String>]: The unique identifier of groupPolicyPresentationValue
[Id <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
[LocalizedNotificationMessageId <String>]: The unique identifier of localizedNotificationMessage
[MacOSSoftwareUpdateAccountSummaryId <String>]: The unique identifier of macOSSoftwareUpdateAccountSummary
[MacOSSoftwareUpdateCategorySummaryId <String>]: The unique identifier of macOSSoftwareUpdateCategorySummary
[MacOSSoftwareUpdateStateSummaryId <String>]: The unique identifier of macOSSoftwareUpdateStateSummary
[MalwareStateForWindowsDeviceId <String>]: The unique identifier of malwareStateForWindowsDevice
[ManagedDeviceCleanupRuleId <String>]: The unique identifier of managedDeviceCleanupRule
[ManagedDeviceEncryptionStateId <String>]: The unique identifier of managedDeviceEncryptionState
[ManagedDeviceId <String>]: The unique identifier of managedDevice
[ManagedDeviceMobileAppConfigurationStateId <String>]: The unique identifier of managedDeviceMobileAppConfigurationState
[ManagedDeviceWindowsOperatingSystemImageId <String>]: The unique identifier of managedDeviceWindowsOperatingSystemImage
[MicrosoftTunnelConfigurationId <String>]: The unique identifier of microsoftTunnelConfiguration
[MicrosoftTunnelHealthThresholdId <String>]: The unique identifier of microsoftTunnelHealthThreshold
[MicrosoftTunnelServerId <String>]: The unique identifier of microsoftTunnelServer
[MicrosoftTunnelServerLogCollectionResponseId <String>]: The unique identifier of microsoftTunnelServerLogCollectionResponse
[MicrosoftTunnelSiteId <String>]: The unique identifier of microsoftTunnelSite
[MobileAppTroubleshootingEventId <String>]: The unique identifier of mobileAppTroubleshootingEvent
[NotificationMessageTemplateId <String>]: The unique identifier of notificationMessageTemplate
[Platform <DevicePlatformType?>]: Usage: platform='{platform}'
[PolicyId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
[RemoteActionAuditId <String>]: The unique identifier of remoteActionAudit
[SecretReferenceValueId <String>]: Usage: secretReferenceValueId='{secretReferenceValueId}'
[SecurityBaselineSettingStateId <String>]: The unique identifier of securityBaselineSettingState
[SecurityBaselineStateId <String>]: The unique identifier of securityBaselineState
[SettingStateDeviceSummaryId <String>]: The unique identifier of settingStateDeviceSummary
[TemplateId <String>]: Usage: templateId='{templateId}'
[Upn <String>]: Usage: upn='{upn}'
[UserPrincipalName <String>]: Usage: userPrincipalName='{userPrincipalName}'
[WindowsDeviceMalwareStateId <String>]: The unique identifier of windowsDeviceMalwareState
[WindowsInformationProtectionAppLearningSummaryId <String>]: The unique identifier of windowsInformationProtectionAppLearningSummary
[WindowsInformationProtectionNetworkLearningSummaryId <String>]: The unique identifier of windowsInformationProtectionNetworkLearningSummary
[WindowsMalwareInformationId <String>]: The unique identifier of windowsMalwareInformation
[WindowsQualityUpdateProfileAssignmentId <String>]: The unique identifier of windowsQualityUpdateProfileAssignment
[WindowsQualityUpdateProfileId <String>]: The unique identifier of windowsQualityUpdateProfile
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