Share via


Microsoft.Graph.Beta.NetworkAccess Module

Microsoft Graph PowerShell Cmdlets

Microsoft.Graph.Beta.NetworkAccess Cmdlets

Cmdlet Description
Get-MgBetaNetworkAccessAlert

Get alerts from networkAccess

Get-MgBetaNetworkAccessAlertCount

Get the number of the resource

Get-MgBetaNetworkAccessAlertFrequency

Invoke function getAlertFrequencies

Get-MgBetaNetworkAccessAlertPolicy

The filtering policy associated with the alert. This relationship allows you to retrieve or manage the filtering policy that triggered or is related to the alert instance.

Get-MgBetaNetworkAccessAlertSeveritySummary

Invoke function getAlertSeveritySummaries

Get-MgBetaNetworkAccessAlertSummary

Invoke function getAlertSummaries

Get-MgBetaNetworkAccessConnectivity

Connectivity represents all the connectivity components in Global Secure Access.

Get-MgBetaNetworkAccessConnectivityBranch

Retrieve information about a specific branch.

Get-MgBetaNetworkAccessConnectivityBranchConnectivityConfiguration

Retrieve the IPSec tunnel configuration required to establish a bidirectional communication link between your organization's router and the Microsoft gateway. This information is vital for configuring your router (customer premise equipment) after creating a deviceLink.

Get-MgBetaNetworkAccessConnectivityBranchConnectivityConfigurationLink

List of connectivity configurations for deviceLink objects.

Get-MgBetaNetworkAccessConnectivityBranchConnectivityConfigurationLinkCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityBranchCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityBranchDeviceLink

Each unique CPE device associated with a branch is specified. Supports $expand.

Get-MgBetaNetworkAccessConnectivityBranchDeviceLinkCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityBranchForwardingProfile

Each forwarding profile associated with a branch site is specified. Supports $expand.

Get-MgBetaNetworkAccessConnectivityBranchForwardingProfileCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityBranchForwardingProfilePolicy

The traffic forwarding policies associated with this profile.

Get-MgBetaNetworkAccessConnectivityBranchForwardingProfilePolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityBranchForwardingProfileServicePrincipal

Get servicePrincipal from networkAccess

Get-MgBetaNetworkAccessConnectivityRemoteNetwork

The locations, such as branches, that are connected to Global Secure Access services through an IPsec tunnel.

Get-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfiguration

Specifies the connectivity details of all device links associated with a remote network.

Get-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfigurationLink

List of connectivity configurations for deviceLink objects.

Get-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfigurationLinkCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityRemoteNetworkCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityRemoteNetworkDeviceLink

Retrieves a specific device link associated with a remote network.

Get-MgBetaNetworkAccessConnectivityRemoteNetworkDeviceLinkCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfile

Each forwarding profile associated with a remote network is specified. Supports $expand and $select.

Get-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfileCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfilePolicy

The traffic forwarding policies associated with this profile.

Get-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfilePolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfileServicePrincipal

Get servicePrincipal from networkAccess

Get-MgBetaNetworkAccessFilteringPolicy

Get a filteringPolicy object.

Get-MgBetaNetworkAccessFilteringPolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessFilteringPolicyRule

Represents the definition of the policy ruleset that makes up the core definition of a policy.

Get-MgBetaNetworkAccessFilteringPolicyRuleCount

Get the number of the resource

Get-MgBetaNetworkAccessFilteringProfile

A filtering profile associates network access policies with Microsoft Entra ID Conditional Access policies, so that access policies can be applied to users and groups.

Get-MgBetaNetworkAccessFilteringProfileConditionalAccessPolicy

A set of associated policies defined to regulate access to resources or systems based on specific conditions. Automatically expanded.

Get-MgBetaNetworkAccessFilteringProfileConditionalAccessPolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessFilteringProfileCount

Get the number of the resource

Get-MgBetaNetworkAccessFilteringProfilePolicy

Get a tlsInspectionPolicyLink object.

Get-MgBetaNetworkAccessFilteringProfilePolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessForwardingPolicy

Retrieve information about a specific forwarding policy.

Get-MgBetaNetworkAccessForwardingPolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessForwardingPolicyRule

Represents the definition of the policy ruleset that makes up the core definition of a policy.

Get-MgBetaNetworkAccessForwardingPolicyRuleCount

Get the number of the resource

Get-MgBetaNetworkAccessForwardingProfile

Retrieve information about a specific forwarding profile.

Get-MgBetaNetworkAccessForwardingProfileCount

Get the number of the resource

Get-MgBetaNetworkAccessForwardingProfilePolicy

Retrieve information about a specific link between a forwarding policy and a forwarding profile.

Get-MgBetaNetworkAccessForwardingProfilePolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessForwardingProfileServicePrincipal

Get servicePrincipal from networkAccess

Get-MgBetaNetworkAccessLog

Represents network connections that are routed through Global Secure Access.

Get-MgBetaNetworkAccessLogConnection

Read the properties and relationships of a connection object.

Get-MgBetaNetworkAccessLogConnectionCount

Get the number of the resource

Get-MgBetaNetworkAccessLogRemoteNetwork

A collection of remote network health events.

Get-MgBetaNetworkAccessLogRemoteNetworkCount

Get the number of the resource

Get-MgBetaNetworkAccessLogTraffic

A network access traffic log entry that contains comprehensive information about network traffic events.

Get-MgBetaNetworkAccessLogTrafficCount

Get the number of the resource

Get-MgBetaNetworkAccessLogTrafficDevice

Represents the device associated with the network traffic, providing details about the hardware or virtual machine involved in the transaction.

Get-MgBetaNetworkAccessLogTrafficUser

Represents the user associated with the network traffic, providing details about the individual or account initiating the transaction.

Get-MgBetaNetworkAccessLogTrafficUserMailboxSetting

Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. For more information, see User preferences for languages and regional formats. Returned only on $select.

Get-MgBetaNetworkAccessLogTrafficUserServiceProvisioningError

Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object.

Get-MgBetaNetworkAccessLogTrafficUserServiceProvisioningErrorCount

Get the number of the resource

Get-MgBetaNetworkAccessReport

Represents the status of the Global Secure Access services for the tenant.

Get-MgBetaNetworkAccessReportConnectionSummary

An API part of Global Secure Access (GSA) product, reports of connections count per traffic type: Private/Internet/Microsoft.

Get-MgBetaNetworkAccessReportCrossTenantSummary

Get a summary of the cross-tenant access patterns.

Get-MgBetaNetworkAccessReportDestinationSummary

Get counts of the visits to the top destination aggregations.

Get-MgBetaNetworkAccessReportDeviceUsageSummary

Get a summary of device onboarding and offboarding within a specified timeframe. This summary includes the total number of devices, active devices, and inactive devices.

Get-MgBetaNetworkAccessReportDiscoveredApplicationSegmentReport

Returns a collection of discoveredApplicationSegmentReport based on aggregated traffic logs for a given period.

Get-MgBetaNetworkAccessRootNetworkAccessRoot

Get networkAccess

Get-MgBetaNetworkAccessSetting

Global Secure Access settings.

Get-MgBetaNetworkAccessSettingConditionalAccess

Retrieve the conditional access settings, which include the preservation of the original source IP address in network traffic for accurate identification and tracking, and the establishment of scalable network connectivity through the Global Secure Access services.

Get-MgBetaNetworkAccessSettingCrossTenantAccess

Retrieve the cross-tenant access settings, which include network packet tagging to enforce Tenant Restrictions Policies (TRv2 Policies) aimed at preventing data exfiltration to external tenants.

Get-MgBetaNetworkAccessSettingForwardingOption

Retrieve the forwarding options for the tenant, with a specific focus on the 'skipDnsLookupState' flag. This flag determines whether DNS lookup will be skipped, allowing Microsoft 365 traffic to be forwarded directly to the Front Door using the client-resolved destination.

Get-MgBetaNetworkAccessTenantStatus

Retrieve the onboarding status of a specific tenant.

Get-MgBetaNetworkAccessThreatIntelligencePolicy

Read the properties and relationships of a threatIntelligencePolicy object.

Get-MgBetaNetworkAccessThreatIntelligencePolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessThreatIntelligencePolicyRule

Represents the definition of the policy ruleset that makes up the core definition of a policy.

Get-MgBetaNetworkAccessThreatIntelligencePolicyRuleCount

Get the number of the resource

Get-MgBetaNetworkAccessTl

A container for tenant-level TLS inspection settings for Global Secure Access.

Get-MgBetaNetworkAccessTlExternalCertificateAuthorityCertificate

Get a externalCertificateAuthorityCertificate object.

Get-MgBetaNetworkAccessTlExternalCertificateAuthorityCertificateCount

Get the number of the resource

Get-MgBetaNetworkAccessTlInspectionPolicy

Get a tlsInspectionPolicy object.

Get-MgBetaNetworkAccessTlInspectionPolicyCount

Get the number of the resource

Get-MgBetaNetworkAccessTlInspectionPolicyRule

Get a tlsInspectionRule object.

Get-MgBetaNetworkAccessTlInspectionPolicyRuleCount

Get the number of the resource

Invoke-MgBetaCrossNetworkAccessReportTenantAccessReport

Invoke function crossTenantAccessReport

Invoke-MgBetaEntityNetworkAccessReportSummary

Get the number of users, devices, and workloads per traffic type in a specified time period.

Invoke-MgBetaOnboardNetworkAccess

Invoke action onboard

Invoke-MgBetaReportNetworkAccessReportDestination

Invoke function destinationReport

Invoke-MgBetaReportNetworkAccessReportDevice

Invoke function deviceReport

Invoke-MgBetaReportNetworkAccessReportUser

Invoke function userReport

Invoke-MgBetaTransactionNetworkAccessReportSummary

Get the total number of transactions and the number of blocked transactions, grouped by traffic type.

Invoke-MgBetaUsageNetworkAccessReportProfiling

Returns an object containing count tables for the traffic types in Global Secure Access, aggregated by the time period specified.

Invoke-MgBetaWebNetworkAccessReportCategoryReport

Invoke function webCategoryReport

New-MgBetaNetworkAccessAlert

Create new navigation property to alerts for networkAccess

New-MgBetaNetworkAccessConnectivityBranch

Create a new branch.

New-MgBetaNetworkAccessConnectivityBranchConnectivityConfigurationLink

Create new navigation property to links for networkAccess

New-MgBetaNetworkAccessConnectivityBranchDeviceLink

Create a branch site with associated device links.

New-MgBetaNetworkAccessConnectivityBranchForwardingProfile

Create new navigation property to forwardingProfiles for networkAccess

New-MgBetaNetworkAccessConnectivityBranchForwardingProfilePolicy

Create new navigation property to policies for networkAccess

New-MgBetaNetworkAccessConnectivityRemoteNetwork

Create a new remote network.

New-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfigurationLink

Create new navigation property to links for networkAccess

New-MgBetaNetworkAccessConnectivityRemoteNetworkDeviceLink

Create new navigation property to deviceLinks for networkAccess

New-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfile

Create new navigation property to forwardingProfiles for networkAccess

New-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfilePolicy

Create new navigation property to policies for networkAccess

New-MgBetaNetworkAccessFilteringPolicy

Create new navigation property to filteringPolicies for networkAccess

New-MgBetaNetworkAccessFilteringPolicyRule

Create new navigation property to policyRules for networkAccess

New-MgBetaNetworkAccessFilteringProfile

Create new navigation property to filteringProfiles for networkAccess

New-MgBetaNetworkAccessFilteringProfilePolicy

Create a new tlsInspectionPolicyLink to connect a filtering profile with a tlsInspectionPolicy. One 1 tlsInspectionPolicy is allowed for every filtering profile.

New-MgBetaNetworkAccessForwardingPolicy

Create new navigation property to forwardingPolicies for networkAccess

New-MgBetaNetworkAccessForwardingPolicyRule

Create new navigation property to policyRules for networkAccess

New-MgBetaNetworkAccessForwardingProfile

Create new navigation property to forwardingProfiles for networkAccess

New-MgBetaNetworkAccessForwardingProfilePolicy

Create new navigation property to policies for networkAccess

New-MgBetaNetworkAccessLogConnection

Create new navigation property to connections for networkAccess

New-MgBetaNetworkAccessLogRemoteNetwork

Create new navigation property to remoteNetworks for networkAccess

New-MgBetaNetworkAccessLogTraffic

Create new navigation property to traffic for networkAccess

New-MgBetaNetworkAccessThreatIntelligencePolicy

Create a new threatIntelligencePolicy object.

New-MgBetaNetworkAccessThreatIntelligencePolicyRule

Create new navigation property to policyRules for networkAccess

New-MgBetaNetworkAccessTlExternalCertificateAuthorityCertificate

Create a new externalCertificateAuthorityCertificate object. This request generates the Certificate Signing Request (CSR) that you download to sign and generate a certificate that you upload to the service using the Update externalCertificateAuthorityCertificate operation.

New-MgBetaNetworkAccessTlInspectionPolicy

Create a new tlsInspectionPolicy object.

New-MgBetaNetworkAccessTlInspectionPolicyRule

Create a new tlsInspectionRule object in a tlsInspectionPolicy.

Remove-MgBetaNetworkAccessAlert

Delete navigation property alerts for networkAccess

Remove-MgBetaNetworkAccessConnectivity

Delete navigation property connectivity for networkAccess

Remove-MgBetaNetworkAccessConnectivityBranch

Delete a specific branch.

Remove-MgBetaNetworkAccessConnectivityBranchConnectivityConfiguration

Delete navigation property connectivityConfiguration for networkAccess

Remove-MgBetaNetworkAccessConnectivityBranchConnectivityConfigurationLink

Delete navigation property links for networkAccess

Remove-MgBetaNetworkAccessConnectivityBranchDeviceLink

Removes the link between the branch or remote network and the CPE device, effectively removing the connection and associated configuration between them.

Remove-MgBetaNetworkAccessConnectivityBranchForwardingProfile

Delete navigation property forwardingProfiles for networkAccess

Remove-MgBetaNetworkAccessConnectivityBranchForwardingProfilePolicy

Delete navigation property policies for networkAccess

Remove-MgBetaNetworkAccessConnectivityRemoteNetwork

Delete navigation property remoteNetworks for networkAccess

Remove-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfiguration

Delete navigation property connectivityConfiguration for networkAccess

Remove-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfigurationLink

Delete navigation property links for networkAccess

Remove-MgBetaNetworkAccessConnectivityRemoteNetworkDeviceLink

Removes the link between the branch or remote network and the CPE device, effectively removing the connection and associated configuration between them.

Remove-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfile

Delete navigation property forwardingProfiles for networkAccess

Remove-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfilePolicy

Delete navigation property policies for networkAccess

Remove-MgBetaNetworkAccessFilteringPolicy

Delete navigation property filteringPolicies for networkAccess

Remove-MgBetaNetworkAccessFilteringPolicyRule

Delete navigation property policyRules for networkAccess

Remove-MgBetaNetworkAccessFilteringProfile

Delete navigation property filteringProfiles for networkAccess

Remove-MgBetaNetworkAccessFilteringProfilePolicy

Delete a tlsInspectionPolicyLink object. Used to unlink a tlsInspectionPolicy from a filtering profile.

Remove-MgBetaNetworkAccessForwardingPolicy

Delete navigation property forwardingPolicies for networkAccess

Remove-MgBetaNetworkAccessForwardingPolicyRule

Delete navigation property policyRules for networkAccess

Remove-MgBetaNetworkAccessForwardingProfile

Delete navigation property forwardingProfiles for networkAccess

Remove-MgBetaNetworkAccessForwardingProfilePolicy

Delete navigation property policies for networkAccess

Remove-MgBetaNetworkAccessLog

Delete navigation property logs for networkAccess

Remove-MgBetaNetworkAccessLogConnection

Delete navigation property connections for networkAccess

Remove-MgBetaNetworkAccessLogRemoteNetwork

Delete navigation property remoteNetworks for networkAccess

Remove-MgBetaNetworkAccessLogTraffic

Delete navigation property traffic for networkAccess

Remove-MgBetaNetworkAccessReport

Delete navigation property reports for networkAccess

Remove-MgBetaNetworkAccessSetting

Delete navigation property settings for networkAccess

Remove-MgBetaNetworkAccessSettingConditionalAccess

Delete navigation property conditionalAccess for networkAccess

Remove-MgBetaNetworkAccessSettingCrossTenantAccess

Delete navigation property crossTenantAccess for networkAccess

Remove-MgBetaNetworkAccessSettingForwardingOption

Delete navigation property forwardingOptions for networkAccess

Remove-MgBetaNetworkAccessTenantStatus

Delete navigation property tenantStatus for networkAccess

Remove-MgBetaNetworkAccessThreatIntelligencePolicy

Delete a threatIntelligencePolicy object.

Remove-MgBetaNetworkAccessThreatIntelligencePolicyRule

Delete navigation property policyRules for networkAccess

Remove-MgBetaNetworkAccessTl

Delete navigation property tls for networkAccess

Remove-MgBetaNetworkAccessTlExternalCertificateAuthorityCertificate

Delete an externalCertificateAuthorityCertificate object.

Remove-MgBetaNetworkAccessTlInspectionPolicy

Delete a tlsInspectionPolicy object.

Remove-MgBetaNetworkAccessTlInspectionPolicyRule

Delete a tlsInspectionRule object.

Update-MgBetaNetworkAccessAlert

Update the navigation property alerts in networkAccess

Update-MgBetaNetworkAccessConnectivity

Update the navigation property connectivity in networkAccess

Update-MgBetaNetworkAccessConnectivityBranch

Update the configuration or properties of a specific branch.

Update-MgBetaNetworkAccessConnectivityBranchConnectivityConfiguration

Update the navigation property connectivityConfiguration in networkAccess

Update-MgBetaNetworkAccessConnectivityBranchConnectivityConfigurationLink

Update the navigation property links in networkAccess

Update-MgBetaNetworkAccessConnectivityBranchDeviceLink

Update the device link associated with a specific branch or remote network.

Update-MgBetaNetworkAccessConnectivityBranchForwardingProfile

Update the navigation property forwardingProfiles in networkAccess

Update-MgBetaNetworkAccessConnectivityBranchForwardingProfilePolicy

Update the navigation property policies in networkAccess

Update-MgBetaNetworkAccessConnectivityRemoteNetwork

Update the navigation property remoteNetworks in networkAccess

Update-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfiguration

Update the navigation property connectivityConfiguration in networkAccess

Update-MgBetaNetworkAccessConnectivityRemoteNetworkConnectivityConfigurationLink

Update the navigation property links in networkAccess

Update-MgBetaNetworkAccessConnectivityRemoteNetworkDeviceLink

Update the navigation property deviceLinks in networkAccess

Update-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfile

Update the navigation property forwardingProfiles in networkAccess

Update-MgBetaNetworkAccessConnectivityRemoteNetworkForwardingProfilePolicy

Update the navigation property policies in networkAccess

Update-MgBetaNetworkAccessFilteringPolicy

Update the navigation property filteringPolicies in networkAccess

Update-MgBetaNetworkAccessFilteringPolicyRule

Update the navigation property policyRules in networkAccess

Update-MgBetaNetworkAccessFilteringProfile

Update the properties of a filteringProfile object.

Update-MgBetaNetworkAccessFilteringProfilePolicy

Update the properties of a threatIntelligencePolicyLink object.

Update-MgBetaNetworkAccessForwardingPolicy

Update the navigation property forwardingPolicies in networkAccess

Update-MgBetaNetworkAccessForwardingProfile

Update an existing forwarding profile.

Update-MgBetaNetworkAccessForwardingProfilePolicy

Update an existing forwarding policy link to modify the association between a forwarding policy and a forwarding profile. This operation allows for linking or unlinking them as needed.

Update-MgBetaNetworkAccessLog

Update the navigation property logs in networkAccess

Update-MgBetaNetworkAccessLogConnection

Update the navigation property connections in networkAccess

Update-MgBetaNetworkAccessLogRemoteNetwork

Update the navigation property remoteNetworks in networkAccess

Update-MgBetaNetworkAccessLogTraffic

Update the navigation property traffic in networkAccess

Update-MgBetaNetworkAccessLogTrafficUserMailboxSetting

Update property mailboxSettings value.

Update-MgBetaNetworkAccessReport

Update the navigation property reports in networkAccess

Update-MgBetaNetworkAccessRootNetworkAccessRoot

Update networkAccess

Update-MgBetaNetworkAccessSetting

Update the navigation property settings in networkAccess

Update-MgBetaNetworkAccessSettingConditionalAccess

Update the conditional access settings to include the preservation of the original source IP address in network traffic for accurate identification and tracking, as well as the establishment of scalable network connectivity through the Global Secure Access services.

Update-MgBetaNetworkAccessSettingCrossTenantAccess

Update the cross-tenant access settings to include network packet tagging for enforcing Tenant Restrictions Policies (TRv2 Policies) that prevent data exfiltration to external tenants.

Update-MgBetaNetworkAccessSettingForwardingOption

the forwarding options for the tenant, with a specific focus on the skipDnsLookupState flag. This flag determines whether DNS lookup will be skipped, allowing Microsoft 365 traffic to be forwarded directly to the Front Door using the client-resolved destination.

Update-MgBetaNetworkAccessTenantStatus

Update the navigation property tenantStatus in networkAccess

Update-MgBetaNetworkAccessThreatIntelligencePolicy

Update the properties of a threatIntelligencePolicy object.

Update-MgBetaNetworkAccessThreatIntelligencePolicyRule

Update the navigation property policyRules in networkAccess

Update-MgBetaNetworkAccessTl

Update the navigation property tls in networkAccess

Update-MgBetaNetworkAccessTlExternalCertificateAuthorityCertificate

Update the properties of an externalCertificateAuthorityCertificate object. This can be used by a GSA admin to upload the generated certificate for GSA. The certificate is generated by signing the downloaded CSR with the customer's PKI.

Update-MgBetaNetworkAccessTlInspectionPolicy

Update the properties of a tlsInspectionPolicy object.

Update-MgBetaNetworkAccessTlInspectionPolicyRule

Update the properties of a tlsInspectionRule object.