Retrieving Citrix Zone Objects

Retrieves the specified Citrix Zone object(s).


Examples:


Hint: The execution of these examples requires a connected PowerShell drive.


Retrieve the Citrix Zone object "Zone-CHI" underneath the farm "XA65Farm" from the container "Managed Users & Computers\solys.local\Citrix\XenApp":


Get-EmdbCitrixZone "emdb:\rootDSE\Managed Users & Computers\solys.local\Citrix\XenApp\XA65Farm\Zone-CHI"


Retrieve all Citrix Zone objects from the container "Managed Users & Computers\solys.local" and its subcontainers:


Get-EmdbCitrixZone "emdb:\rootDSE\Managed Users & Computers\solys.local\*" -Recurse


Retrieve the Citrix Zone object "DC London" in the current context through its Item-ID (this ID will vary in different DSM environments):


Get-EmdbCitrixZone -ItemID 7519 -Recurse


Tip: the alias ID can be used instead of ItemID.


Retrieve the Citrix Zone object "Zone-CHI" underneath the farm "XA65Farm" from the current context using the cmdlet Get-Item:


Cd "emdb:\rootDSE\Managed Users & Computers\solys.local\Citrix\XenApp\XA65Farm"

Get-Item "Zone-CHI"


Retrieve all Citrix Zone objects from the container "Managed Users & Computers\solys.local" and its subcontainers using the cmdlet Get-ChildItem:


Get-ChildItem "emdb:\rootDSE\Managed Users & Computers" -Filter "SchemaTag=CitrixZone" -Recurse


Starting with PSX 3.1 there was a new option implemented when retrieving Citrix Zone objects. When specifying the SingleItemExpected-switch it is expected, that none or exactly one object is contained in the result. If the retrieval returns more than one object, an error is raised that can be caught and handled in scripts.