网络位置

Last published : Oct 24, 2026
在 Citrix Cloud™ 中，您可以根据公共 IP 地址配置网络位置。这些网络位置可用于以下目的：
  • Citrix® StoreFront Cloud 使用网络位置来确定是指示客户端直接连接到 VDA 还是通过 Citrix Gateway 连接。有关详细信息，请参阅 连接到 DaaS 资源。
  • 当用户从网络位置连接时，StoreFront Cloud 可以添加智能访问标签，您可以将其用作 Studio 中访问策略的输入。有关详细信息，请参阅 基于用户网络位置的自适应访问。此功能仅在启用 自适应访问 时可用。
  • 您可以根据用户的网络位置选择用户身份验证方式。有关详细信息，请参阅 条件身份验证。
  • 您可以根据网络位置连接类型配置不同的超时。有关详细信息，请参阅 根据网络连接类型配置会话。
通常，您会为每个办公地点创建一个网络位置。
注意：
无法区分具有相同公共 IP 地址的不同网络。例如，如果您的公司网络和访客 Wi-Fi 网络共享一个公共 IP 地址，则它们被视为相同的网络位置。

查看网络位置

要查看已配置的网络位置：
  1. 登录 Citrix Cloud。
  2. 打开主菜单。
  3. 从主菜单中选择 网络位置。
  4. 网络位置屏幕加载。
    网络位置屏幕

添加网络位置

  1. 在“网络位置”屏幕上，按 添加网络位置
    添加网络位置
    仅当启用 Adaptive Access 时，位置标签 和 连接类型 选项才可用。
  2. 输入 位置名称。
  3. 以 CIDR 格式输入 公共 IP 地址范围。
  4. 如果启用了 Adaptive Access，您可以选择输入一个或多个 位置标签 的名称。使用逗号分隔多个标签。智能访问标签是通过添加后缀 LOCATION_TAG_ 生成的。例如，如果您输入位置标签 BranchOffice，则会生成一个名为 LOCATION_TAG_BranchOffice 的智能访问标签，您可以在 Studio 中使用它。
  5. 如果启用了 Adaptive Access，您可以选择位置是 内部 还是 外部。对于所有内部位置，会生成一个名为 LOCATION_internal 的智能访问标签。对于所有外部位置，会生成一个名为 LOCATION_external 的智能访问标签。如果客户端的 IP 地址与网络位置不匹配，则该网络位置被视为 未定义。
    如果 Adaptive Access 被禁用，则此选项将被隐藏。所有配置的网络位置都被视为内部位置，并且不会创建任何智能访问标签。
  6. 按 保存。

编辑网络位置

  1. 导航到并打开“网络位置”屏幕
  2. 在您希望编辑的行上，按 ... 打开菜单，然后选择 编辑。
  3. 进行必要的更改。
  4. 按下保存。

删除网络位置

  1. 导航到“网络位置”屏幕
  2. 在您希望编辑的行上，按下**...以打开菜单，然后选择删除**。
  3. 在确认屏幕上，按下是，删除。

使用 PowerShell 管理网络位置

您可以使用 PowerShell 脚本配置直接工作负载连接，而不是使用 Citrix Cloud 管理控制台界面。使用 PowerShell 配置直接工作负载连接涉及以下内容：
  1. 下载 PowerShell 模块。
  2. 在 Citrix Cloud 中创建服务主体，并记下客户端 ID 和密钥。
  3. 导入 PowerShell 模块 并使用您的 API 客户端详细信息连接到网络位置服务 (NLS)。
  4. 使用 PowerShell cmdlet 为您的每个位置创建网络位置。

下载 PowerShell 模块

在设置网络位置之前，请从 Citrix GitHub 存储库下载 Citrix 提供的 PowerShell 模块 (nls.psm1)。使用此模块，您可以根据 VDA 的需要设置任意数量的网络位置。
  1. 在 Web 浏览器中，转到 <https://github.com/citrix/sample-scripts/blob/master/workspace/NLS2.psm1>。
  2. 按下 Raw。
  3. 按 Ctrl+S 并选择一个位置来保存文件。

创建服务主体

  1. 在 Citrix Cloud 控制台中，单击左上角的菜单。
    Citrix 菜单
  2. 选择 身份和访问管理 > API 访问 > 服务主体 > 创建服务主体，然后按照步骤完成操作。
    如果这些选项未显示，您可能没有足够的权限来管理服务主体。请联系您的管理员以获取所需的完全访问权限。
  3. 在“服务主体”选项卡上，记下您的客户 ID。
    身份和访问管理 服务主体
  4. 将凭据添加到您的密钥管理工具中，因为该密钥只会显示一次。
    ID 和密钥

配置网络位置

  1. 打开 PowerShell 命令窗口，然后导航到保存 PowerShell 模块的目录。
  2. 导入模块：Import-Module .\nls.psm1 -Force
  3. 使用 中的服务主体信息设置所需的变量：(#create-a-secure-client):
    • $clientId = "YourServicePrincipalClientId"
    • $customer = "YourCustomerID"
    • $clientSecret = "YourServicePrincipalSecret"
  4. 使用您的服务主体凭据连接到网络位置服务：
    Connect-NLS -clientId $clientId -clientSecret $clientSecret -customer $customer
  5. 创建一个网络位置，将参数值替换为与内部用户直接连接的内部网络相对应的值：
    New-NLSSite -name "YourSiteName" -tags @("YourTags") -ipv4Ranges @("PublicIpsOfYourNetworkSites") -longitude 12.3456 -latitude 12.3456 -internal $True
    要指定单个 IP 地址而不是范围，请在 IP 地址末尾添加 /32。例如：
    New-NLSSite -name "YourSiteName" -tags @("YourTags") -ipv4Ranges @("PublicIpOfYourNetworkSite/32") -longitude 12.3456 -latitude 12.3456 -internal $True
    重要提示：
    使用 New-NLSSite 命令时，请为每个参数至少包含一个值。如果您在不带任何命令行参数的情况下运行此命令，PowerShell 将提示您逐个输入每个参数的相应值。internal 属性是一个强制性布尔属性，可能的值为：$True 或 $False，它通过 PowerShell 映射到 UI。例如，(UI) Network Internal -> (PowerShell) –internal=$True。
    成功创建网络位置后，命令窗口将显示网络位置的详细信息。
  6. 对所有用户连接的网络位置重复步骤 5。
  7. 运行命令 Get-NLSSite 以返回您使用 NLS 配置的所有站点的列表，并验证其详细信息是否正确。

修改网络位置

要更改现有网络位置：
  1. 在 PowerShell 命令窗口中，列出所有现有网络位置：Get-NLSSite
  2. 要修改特定网络位置的 IP 范围，请键入
    (Get-NLSSite)[N] | Set-NLSSite -ipv4Ranges @("1.2.3.4/32","4.3.2.1/32")
    其中 [N] 是列表中位置对应的数字（从零开始），且 "1.2.3.4/32","4.3.2.1/32" 是您要使用的逗号分隔的 IP 范围。例如，要修改列表中的第一个位置，请键入以下命令：
    (Get-NLSSite)[0] | Set-NLSSite -ipv4Ranges @("98.0.0.1/32","141.43.0.0/24")

删除网络位置

要删除不再使用的网络位置：
  1. 在 PowerShell 命令窗口中，列出所有现有网络位置：Get-NLSSite
  2. 要删除所有网络位置，请键入 Get-NLSSite | Remove-NLSSite
  3. 要删除特定的网络位置，请键入 (Get-NLSSite)[N] | Remove-NLSSite，其中 [N] 是列表中位置对应的数字。例如，要删除列表中的第一个位置，请键入 (Get-NLSSite)[0] | Remove-NLSSite。

示例脚本

示例脚本包含您可能需要添加、修改和删除分支位置的公共 IP 地址范围的所有命令。但是，您无需运行所有命令来执行任何单个功能。要运行脚本，请始终包含前 10 行，从 Import-Module 到 Connect-NLS。之后，您只需包含要执行功能的命令即可。
Import-Module .\nls.psm1 -Force

$clientId = "XXXX" #Replace with your clientId
$clientSecret = "YYY"    #Replace with your clientSecret
$customer = "CCCCCC"  #Replace with your customerid

# Connect to Network Location Service
Connect-NLS -clientId $clientId -clientSecret $clientSecret -customer $customer

# Create a new Network Location Service Site (Replace with details corresponding to your branch locations)
New-NLSSite -name "New York" -tags @("EastCoast") -ipv4Ranges @("1.2.3.0/24") -longitude 40.7128 -latitude -74.0060 -internal $True

# Get the existing Network Location Service Sites (optional)
Get-NLSSite

# Update the IP Address ranges of your first Network Location Service Site (optional)
$s = (Get-NLSSite)[0]
$s.ipv4Ranges = @("1.2.3.4/32","4.3.2.1/32")
$s | Set-NLSSite

# Remove all Network Location Service Sites (optional)
Get-NLSSite | Remove-NLSSite

# Remove your third site (optional)
(Get-NLSSite)[2] | Remove-NLSSite